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Legal information 


Warning notice system 


This manual contains notices you have to observe in order to ensure your personal safety, as well as to prevent 
damage to property. The notices referring to your personal safety are highlighted in the manual by a safety alert 
symbol, notices referring only to property damage have no safety alert symbol. These notices shown below are 
graded according to the degree of danger. 


indicates that death or severe personal injury will result if proper precautions are not taken. 


A WARNING 
indicates that death or severe personal injury may result if proper precautions are not taken. 


A CAUTION 
indicates that minor personal injury can result if proper precautions are not taken. 


NOTICE 
indicates that property damage can result if proper precautions are not taken. 


If more than one degree of danger is present, the warning notice representing the highest degree of danger will be 
used. A notice warning of injury to persons with a safety alert symbol may also include a warning relating to property 
damage. 


Qualified Personnel 


The product/system described in this documentation may be operated only by personnel qualified for the specific 
task in accordance with the relevant documentation, in particular its warning notices and safety instructions. Qualified 
personnel are those who, based on their training and experience, are capable of identifying risks and avoiding 
potential hazards when working with these products/systems. 


Proper use of Siemens products 


Trademarks 


Note the following: 


A WARNING 


Siemens products may only be used for the applications described in the catalog and in the relevant technical 
documentation. If products and components from other manufacturers are used, these must be recommended or 
approved by Siemens. Proper transport, storage, installation, assembly, commissioning, operation and 
maintenance are required to ensure that the products operate safely and without any problems. The permissible 
ambient conditions must be complied with. The information in the relevant documentation must be observed. 


All names identified by ® are registered trademarks of Siemens AG. The remaining trademarks in this publication 
may be trademarks whose use by third parties for their own purposes could violate the rights of the owner. 


Disclaimer of Liability 


We have reviewed the contents of this publication to ensure consistency with the hardware and software described. 
Since variance cannot be precluded entirely, we cannot guarantee full consistency. However, the information in 
this publication is reviewed regularly and any necessary corrections are included in subsequent editions. 
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1.1 VBS for creating procedures and actions 


Contents 


WinCC provides the possibility of dynamizing the Runtime environment using the Visual Basic 
Script. It is possible to use VBS to program global actions and procedures as well as 
dynamizing graphic objects and triggering actions in Runtime. 


This chapter will show you 


How to work with VBScript editors 

How to create and edit procedures 

How to create and edit actions 

How to activate VBScripts in Runtime 

How to execute diagnostics on scripts in Runtime 
The object model of graphic Runtime system 


Detailed examples on using VBScript 
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7.2 Using Visual Basic Script in WinCC 
1.2 Using Visual Basic Script in WinCC 


Introduction 


In addition to the C script, WinCC also provides the VBScript program language as a 
programming interface in order to make the WinCC Runtime environment dynamic. 


Target Group of the Documentation 


This documentation is aimed at project engineers with experience of Visual Basic or WinCC 
Scriptings (C) used to date. 


Application Options 
VBScript (VBS) provides access to tags and objects of the graphical Runtime system at 
Runtime and can execute picture-independent functions: 


e Tags: Tag values can be read and written in order, for example, to specify tag values for 
the PLC by clicking the mouse when positioned on a button. 


@ Objects: Object properties can be made dynamic using actions and actions can be triggered 
by events influencing objects. 


e Picture-independent Actions: Picture-independent actions can be triggered cyclically or 
according to tag values, e.g. for the daily transfer of values into an Excel table. 


VBS can be used at the following points in WinCC: 


e@ Inthe Global Script Editor: This is used to configure picture-independent actions and 
procedures. The procedures can be used in picture-dependent and picture-independent 
actions. Several procedures are compiled in a topic-related module. 


e In Graphics Designer: Picture-dependent actions can be configured with which the 
properties of graphic objects can be made dynamic or caused to respond to events in 
Runtime. 


@ Inuser-defined menus and toolbars: Here you configure procedures called in Runtime using 
the menu and toolbars. 


Note 
Updating Changed Configuration in Runtime 


A changed VB script that is connected with "Menus and toolbars" is only updated after 
Runtime is restarted. 


If you change the properties of "Menus and toolbars" in Runtime, the changes are only 
applied in the following cases: 

e After a picture change, if the configuration change does not affect the basic picture. 
e@ When you load another configuration file and reload the modified configuration file. 
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1.2 Using Visual Basic Script in WinCC 


Registered Tags in Menus and Toolbars 


The registered tags in the scripts of "Menus and toolbars" remain registered when you unselect 
the picture. If you read indirectly from a process mapping the tags are registered and 
unregistered again when you unselect the picture. However, registered tags in the scripts of 
"Menus and toolbars" remain registered when you unselect the picture. 


Application Scenarios 
VBS can be used in Runtime, for example: 


e to configure setpoint value specification for tags for the operation of a graphic object in 
order to define a value for the PLC by clicking a mouse, for example. 


e@ to configure switching the Runtime language for the operation of a graphic object. 
e to configure the change of color, e.g. cyclically (flashing) or to display statuses (motor on). 


Apart from the specific WinCC applications, the general functionality of VBS can also be used 
to customize the Windows environment, e.g.: 


e to transfer data to another application (e.g. Excel). 
e to start external applications from WinCC. 
e tocreate files and folders. 


The automation objects in your environment are available with which to customize the Windows 
environment. 


Note 


All the objects supplied with the Windows Script Host (WSH) from Microsoft can be integrated 
in the environment using the standard VBS method CreateObject. However, there is no direct 
access to the WSH object itself using VBS from WinCC. 


There is no guarantee nor WinCC support for the VBS functionality with regard to its adaptation 
to the Windows environment. 


Limits to Other Programming Languages in WinCC 


VBS and C 

VBScript can be used in WinCC parallel to C-Script, but do not mix the script types: 

e VBScripts and C-scripts can be configured within a picture and project. 

e C-scripts cannot be invoked in VBScripts and vice versa. 

e VBS provides internal interfaces to tags and picture objects while the C environment 
enables access to other WinCC subsystems (e.g. the report system). 

VBS and VBA 


VBA is used in WinCC Configuration during the configuration in order to adapt Graphics 
Designer to your individual requirements and to simplify and automate configuration. VBA 
programs only run in the WinCC configuration environment. 
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7.2 Using Visual Basic Script in WinCC 


As opposed to VBA, VB scripts only run in WinCC Runtime and, from there, enable access to 
graphic objects and tags. Objects and pictures can be neither created nor modified on a 
permanent basis in VBS, as opposed to VBA. 


The main language-related differences between VBA and VBS are e.g.: 
e VBS was developed for use in Internet, VBA for the automation of software applications. 


e The data type of VBS tags is always VARIANT. VBA, on the other hand, differentiates the 
individual data types such as INT, DOUBLE, STRING, etc. 


@ Certain language constructs from VBA have been removed from or added to VBS. 
e Errors are handled differently in VBS compared to VBA. 


A complete list of the differences between VBA and VBS is provided in the Appendix in "Basic 
Principles of VBScript". 


Procedures, Modules and Actions 
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VBS in WinCC allows the use of procedures, modules and actions to make the Runtime 
environment dynamic: 


e Procedures: Codes are stored in procedures which are then used at several points in the 
configuration. Retrieve the code or another procedure in an action by invoking the 
procedure name. Procedures can be created in WinCC with or without return values. 
Procedures do not have their own trigger, they are always retrieved by an action. 


e Modules: It is advantageous to compile related procedures to units in modules. Create 
modules for procedures, for example, which must be used in a specific picture or belong 
to a specific topic, such as auxiliary mathematical functions or database access functions. 


e Actions: Actions are always activated by a trigger, namely a triggering event. Actions are 
configured in graphic object properties, in events which occur on a graphic object or globally 
in a project. Codes used several times can be called, in the form of procedures, in actions. 


Module 


Procedure A 


Procedure B 


Procedure C 


Instruction-1 
Instruction-2 Instruction-a 
Procedure C Instruction-b 


Trigger 


Instruction-n 


Procedure D 
Procedure E 
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7.3 Modules and Procedures 


1.3 Modules and Procedures 


Introduction 


Procedures are used to make code, created only once, available at several points in a project. 
Instead of entering the code several times, simply call in the corresponding procedure. The 
code is clearer and easier to maintain. 


Action A Action B Action C Action D 
Instruction1 Instruction1 InstructionA InstructionA 
Instruction2 Instruction2 InstructionB InstructionB 
Instruction3 Instruction3 Instruction? InstructionC 


MyModule 


MyProcedure1 
Instruction1 
Instruction2 
Instruction3 


MyProcedure2 
InstructionA 
InstructionB 
InstructionC 


Action A Action B Action C Action D 
MyProcedurel MyProcedure1 MyProcedure2 MyProcedure2 


Related procedures should be stored in modules. When a certain procedure is retrieved via 
an action in Runtime, the module that contains that procedure is loaded. Observe the following 
when structuring the modules and procedures: 


e The more modules that must be loaded when a picture is called in, the worse the 
performance in Runtime. 


e The larger a module, the more procedures are contained and, thus, the longer the loading 
time for the module. 


Organize the modules sensibly, e.g. a module with procedures for a specific system part/ 
picture. 


Another type of structuring of procedures in modules is the functional structuring, e.g. a module 
containing mathematical functions. Use this structure, for example, for modules which should 
be used globally for projects. The following example illustrates a module containing 
mathematical functions derived from the standard functions: 
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iii Global Script VBS - serv1.mcp: (Standard Module) DerivedMathsFcts.bmo Ce) 
File Edit Yiew Paste Options Window Help 

wees eS ee = eee ‘alah, 

3 a Toe 


wax servi1.mcp: (Standard Module) DerivedMathsFcts.bmo xX Vv 


£4Proie...| EiStan... | Actio../ @ Cod... 
| =] = Standard Modules 7 ; ' Inverse Contangent 

So DerivedMathsFcts.bmo [Function Arecontan (Byval X) 
Arccontan Arccotan(X) = Atn({X) + 2 * Atn{i) 
Arcos (End Function 
Arcsec 
Arcsin ' Hyperbolic Sine 
Cosec Function HSin (Byval X) 
Cotan HSin(X) = (Exp(X) - Exp(X)}) / 2 
HCos (End Function 
Hsin 
HTan ' Hyperbolic Cosine 
Sec Function HCos (Byval X) 
# WebNavigatorStd,bmo HCos(X) = (Exp(X) + Exp(-X)) £2 
(End Function 


3 
a 
3 
a 
a 
a 
a 
a 
a 
a 


Output 
Syntax check... 
Creating procedure name list... 


Check of the procedure name... 
No errors occurred. 


Procedure Features 
The procedures in WinCC have the following properties: 
e They are created and modified by the user. 
e They can be protected against modification and viewing by means of a password. 
e@ They do not have a trigger. 
e They are stored in a module. 


WinCC does not provide predefined procedures, but does provide code templates and 
Intellisense, for example, to simplify programming. Procedures differ according to module 
assignment in: 


e Standard procedures apply globally to projects located on the computer on which they were 
created. 


e Project procedures can only be used within the project in which they were created. 
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7.3 Modules and Procedures 


Module Features 


A module is a file in which one or procedures is stored. The modules in WinCC have the 
following properties: 


e They can be protected against modification and viewing by means of a password. 
e The have the file extension *.bmo. 
Modules differ according to the validity of their procedures in: 


@ Standard Modules: Contain procedures which are globally available to the project. Standard 
modules are stored in the WinCC file system under: <WinCC-Installationsverzeichnis> 
\ApLib\ScriptLibStd\<Modulname>.bmo 


e Project Modules: Contain project-specific procedures. Project modules are stored in the 
WinCC file system under: <Projektverzeichnis>\ScriptLib\<Modulname>.bmo. Since the 
project modules are stored in the project directory, they are copied when the WinCC project 
is copied. 


Note 


If WinCC must be reinstalled and the standard procedures and modules need to be used 
again, save the module files prior to the reinstallation in a different directory and copy them 
in the relevant WinCC directory after the reinstallation has been completed. Otherwise, the 
standard modules in the WinCC installation directory are deleted during the installation 
routine. 


Using Procedures and Modules 
Procedures are used in: 
e Actions (in Graphics Designer and Global Script) 
e Other procedures (in Global Script) 
e User-defined menus and toolbars 


Procedures are structured in modules. 


See also 
Creating and Editing Procedures (Page 36) 
VBScript Editors (Page 26) 
Basic Principles of VBScript (Page 861) 
Actions (Page 18) 
Using Visual Basic Script in WinCC (Page 12) 
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1.4 Actions 


Introduction 


Action Features 


Action Trigger 
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An action is always started by a trigger. An action, for example, is triggered in Runtime when 
an object is operated by a mouse click, a certain time has occurred or a tag has been modified. 


Actions are defined once in Global Script and then available independent of the picture. Global 
Script actions are only valid in the project in which they were defined. Actions linked to a graphic 
object are only valid in the picture in which they were defined. 


Note 
VBS does not currently allow the creation of computer-specific actions. 


The following applies for clients in a multi-user system: All global actions configured on a server 
are also executed on a client when a project is opened. 

The following applies to clients in a distributed system: If actions should be used on a client 
computer, copy all the action files in the corresponding project directory on the client. 


Actions have the following properties: 
e Actions are created and modified by the user. 


e Actions in Global Script can be protected against modification and viewing by means of a 
password. 


e Actions have at least one trigger. 
e Actions in Global Script have the file extension *.bac. 


@ Global Script actions are stored in the WinCC file system under: <Projektverzeichnis> 
\ScriptAct\Aktionsname.bac 


Triggers are required to execute actions in Runtime. A trigger is linked to an action thus forming 
the triggering event which calls the action. Actions without triggers will not be carried out. 


The following trigger types are available in WinCC: 
e Timer: Acyclic or cyclic trigger, e.g. for calling a picture or every hour. 
e Tags: Change of value 


e Event: Modification of object properties (e.g. change of color) or event on an object (e.g. 
mouse Click). 
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Processing of Actions in Runtime 


In Graphics Designer 


Two actions of the same type can be executed simultaneously in Runtime. In order, for 
example, that cyclic actions are not hindered by an action executed by a mouse click, event 
triggered actions and cyclic/tag triggered actions in Graphics Designer are executed 
independently of each other. 


Note 


Please note that synchronization between both action types in WinCC may only be executed 
by the DataSet object or by internal WinCC tags. As a result of the separate processing, no 
common data area exists between event triggered and cyclic/tag triggered actions. 


If processing cyclic actions in pictures, for example, is prevented by a high system load or 
another action, the action is started once at the next opportunity. Cycles which are not executed 
are not retained in a queue but rejected. 


After a change of picture, scripts still running are automatically stopped 1 minute after the 
change of picture. 


Scripts which are still running when Runtime is terminated are stopped after 5 seconds. 


In Global Script 


Picture-independent actions from Global Script are executed in Runtime in succession after 
being triggered. If an action is triggered while another action is in progress, the second action 
is retained in a queue until it can be executed. 


Note 


Please note that synchronization between actions in Global Script and in Graphics Designer 
may only be executed by the DataSet object or by internal WinCC tags. There is no common 
data area between the actions in Graphics Designer and in Global Script. 


Using the Actions 


See also 


Actions can be used as follows: 
@ In Global Script The global actions defined here run picture-independent in Runtime. 


e In Graphics Designer: The actions defined here only run in the configured picture. An action 
is configured in Graphics Designer on an object property or an event on a graphic object. 


Creating and Editing Actions (Page 52) 

Basic Principles of VBScript (Page 861) 
Modules and Procedures (Page 15) 

Using Visual Basic Script in WinCC (Page 12) 
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7.5 Multiple Use of Procedures and Actions 


1.5 


Introduction 


Multiple Use of Procedures and Actions 


An action configured with VBS in WinCC is always valid for the project in which it was defined. 
Procedures have the following areas of application: 


e Standard procedures apply globally to projects located on the computer on which they were 
created. 


@ Project procedures can only be used in the project in which they were created. If a project 
is copied, the project procedures (modules) are copied together with the project. 


Multiple Use of Procedures and Actions 


If actions or procedures/modules are to be used in other projects or on other computers, it is 
possible either to: 


e use the "Save As" function to store the action or module in a different project directory or, 
for example, on a disk. 


@ to copy the action or module file in Windows Explorer and paste it in the corresponding 
project or standard directory on the target computer. 


The properties and trigger configured are retained during copying. Copied modules are directly 
available in Runtime. Copied actions are executed in Runtime after they have been opened 
and stored once. 


Note 


Tags used in an action or procedure must also be available on the target computer. If the tag 
is not available, the action or procedure is not executed. 


Procedures which are called in an action must be available on the target computer. If the 
procedure is not available, a Runtime error occurs during Runtime. 


Storing Procedures 
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If procedures need to be copied in other project directories in order to be able to use then in 
other projects or different computers, observe the storage path of the procedures in the WinCC 
file system: 


e Standard procedures: <WinCC-Installationsverzeichnis>\ApLib\ScriptLibStd 
\Modulname.bmo 


@ Project procedures: <Projektverzeichnis>\ScriptLib\Modulname.bmo 


Note 


Since procedures are always stored in modules, always copy the module (*.bmo) in which the 
procedure is contained. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


VBS for Creating Procedures and Actions 


Storing Actions 


See also 


7.5 Multiple Use of Procedures and Actions 


The copied procedures/modules are visible after updating the Global Script navigation window 
(context menu command "Update") or restarting the editor. 


If actions need to be copied in other project directories in order to be able to use then in other 
projects or different computers, observe the storage path of the actions in the WinCC file 
system: 


<Projektverzeichnis>\ScriptAct\Aktionsname.bac 


Each action is stored in a separate file. When an action is copied, all the triggers related to it 
are also copied. 


Note 


Only actions created in Global Script are stored in the WinCC file system. Actions which are 

programmed in Graphics Designer are always stored with the current picture and cannot be 

transferred individually. If a Graphics Designer picture is copied into another project directory, 
the actions stored with the picture are also copied. 


The copied actions are visible after updating the Global Script navigation window (context 
menu command "Update") or restarting the editor. 


Modules and Procedures (Page 15) 

Renaming a Procedure or Module (Page 50) 
Saving a Procedure (Page 48) 

Protecting a Module with a Password (Page 47) 
How to add module-related information (Page 45) 
Using Standard and Project Procedures (Page 44) 
How to Write Procedure Codes (Page 41) 
Creating a New Procedure (Page 39) 

Creating and Editing Procedures (Page 36) 
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1.6 Use of CrossReference 


CrossReference and Tag Trigger 


The CrossReference from WinCC can be used to quickly find all the application points of tags, 
even in VBS actions. Tag triggers in actions in Graphics Designer can be "linked" using 
CrossReference, i.e. replaced by other tags at all or selected points. 


Note 


Tags can also be directly linked in Graphics Designer by marking the graphic object and 
selecting the "Linking ..." command from the shortcut menu. 


Further information on CrossReference is available in the WinCC documentation. 


Actions and CrossReference 


All the actions used in a picture can be displayed by means of the picture properties. To do 
this mark the picture in WinCC Explorer and select the "Properties" shortcut menu command. 
After double clicking on an entry, detailed information on the type of dynamics appears. 


It is also possible to display all the tags and pictures used in actions by means of the WinCC 
CrossReference. CrossReference can also be used for the to link tag connections of Graphics 
Designer actions easily. 


Tags and CrossReference 


* VBS1 


All tags addressed with the following standard formulation are automatically compiled by the 
CrossReference of WinCC and then listed in the picture properties. 


HMTRuntime.Tags ("Tagname") 


' WINCC: TAGNAME 


If tags are addressed with different formulations in the code, this can be notified by the following 
section of the CrossReference: 


| SECTION_START 


Const TagNameInAction = "TagName" 


' WINCC: TAGNAME 
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| SECTION_END 


The section can be inserted in VBS actions as often as required. 


Note 


Itis not possible to guarantee the compilation of combined tag names from the CrossReference. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


VBS for Creating Procedures and Actions 


7.6 Use of CrossReference 


Pictures and CrossReference 


All pictures addressed with the following standard formulation are automatically compiled by 
the CrossReference of WinCC and then listed in the picture properties. 


"VBS2 


HMITRuntime.BaseScreenName = "Screenname" 


If pictures are addressed with different formulations in the code, this can be notified by the 
following section of the CrossReference: 


' WINCC: SCREENNAME SECTION START 


Const ScreenNameInAction = "ScreenName" 


' WINCC:SCREENNAME SECTION END 


The section can be inserted in VBS actions as often as required. 


Note 


Always enter picture names without the extension "PDL" for reasons of compatibility with future 
versions. 


See also 
VBS Reference (Page 105) 
VBScript Editors (Page 26) 
Basic Principles of VBScript (Page 861) 
Actions (Page 18) 
Modules and Procedures (Page 15) 
Using Visual Basic Script in WinCC (Page 12) 
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1.7 Using Global Tags in VBS 


Introduction 


Global tags can be defined in the Global Script Editor which can then be used in all actions 
and procedures. 


Using Global Tags in Graphics Designer and Global Script 


Observe the following conditions when using global tags in Graphics Designer and Global 
Script: 


e Inorder to use a global tag in an action in Graphics Designer, call in the procedure in which 
the tag is defined so that the associated module is loaded in Runtime. 


e In order to use a global tag in an action in Global Script, at least one procedure must be 
activated from the module in at least one global action in which the tag is defined so that 
the module is loaded in Global Script Runtime. This does not need to be the procedure in 
which the tag was defined. 


This process is necessary because actions from Global Script and Graphics Designer are 
processed independently of each other in Runtime. There is no common data area between 
the two Runtime systems. 


If you need to synchronize actions from Global Script and Graphics Designer, use the DataSet 
object or internal WinCC tags. 


Using Global Tags in Graphics Designer 
When using global tags in Graphics Designer, observe the following conditions: 


e@ Inorder to use a global tag in cyclic or tag triggered action in Graphics Designer, call in the 
procedure in which the tag is defined. This also applies when the tag has already been 
called in an event triggered action. 


e In order to use a global tag in an event triggered action in Graphics Designer, call in the 
procedure in which the tag is defined. This also applies when the tag has already been 
called in a cyclic or tag triggered action. 


This process is necessary because the cyclic/tag triggered actions and the event triggered 
actions in Graphics Designer in Runtime are processed independently of each other in 
Runtime. There is no common data area between the two types of action. 


If you need to synchronize cyclic or tag-triggered actions and event-triggered actions, use the 
DataSet object or internal WinCC tags. 


In the case of Graphics Designer, it is also possible to define global tags in a separate 
declaration section. Because event-triggered and cyclic/tag-triggered actions are processed 
separately in Runtime, the global tags can only be jointly addressed within the event-triggered 
or cyclic/tag-triggered actions. 
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See also 
Basic Principles of VBScript (Page 861) 
Structure of VBScript Files (Page 92) 
Creating and Editing Actions (Page 52) 
Creating and Editing Procedures (Page 36) 
VBScript Editors (Page 26) 
Use of CrossReference (Page 22) 
Actions (Page 18) 
Modules and Procedures (Page 15) 
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1.8 VBScript Editors 
1.8.1 VBScript Editors 
Introduction 
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VBScripts can be programmed at two points in WinCC: 


e@ In Global Script Global Script is the central editor for VBS programming. Call it in via WinCC 
Explorer. 


a Report Designer 

3 Global Script 

ef C-Editor 

Ber V85-Editor 

Text Library 

=, Text Distributo — Properties 
ay User Administrator 


e In Graphics Designer: Graphics Designer can be used to program actions related to object 
properties or events related to graphic objects. The action editor in Graphics Designer is 
called in via the context menu in the Properties dialog of a graphic object. 


Object Properties x 


Properties | Events 
Button Attribute Static Dynamic Update Cycle = Indirect 

Geometry Border Color [Es Oo 
Colors Border Background Color [7] ce: Oo 
Styles Background Color a — Oo 
Font Fill Pattern Color a 2 (Dynamic Dialog... oO 
Flashing Font Color a <CAction... Oo 
Miscellaneous 3D Border Color | F{ vBS-Action... | oO 
Filling 3D Shadow Color faa kia... im] 
Pictures 

Effects Delete 


EE] Object Properties ||/—Library 
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Restrictions, Global Script - Graphics Designer 


Graphics Designer can be used to program actions and picture-specific procedures but not 
global procedures valid for the entire project. However, global procedures which were 
programmed in Global Script can be called in. 


Note 


This documentation is used primarily to describe Global Script and, if necessary, makes 
reference to deviations in the functionality compared to Graphics Designer. A detailed 
description of the Graphics Designer action editor is provided in the WinCC help topic 
"Dynamization". 


Further Information 


Further information on "Dynamization" is available in the WinCC documentation. 


See also 

Global Script Editor (Page 27) 
1.8.2 Global Script Editor 
Introduction 


Global procedures and actions are created and edited in the Global Script editor. 


Global Script provides a similar range of functions to that of the C script editor in WinCC. 


Note 


A detailed description of the action editor for the creation of picture-based actions and 
procedures in Graphics Designer is provided under the WinCC help topic "Dynamics". 


Starting Global Script 


Global Script is started using the shortcut menu "Open" command in the WinCC Explorer 
project window. 


& Report Designer 
J. Global Script 
ef C-Editor 


EBPs @vBS-Editor 
Text Library 


= Text Distributo — Properties 
i User Administrator 
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Global Script is also automatically started when a module or action is opened by means of a 
double click in WinCC Explorer. 


Design of Global Script 
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@——_xv File Edit View Paste Options Window Help 
@—jj a} t RosheA ic 


Global Script editor is designed in accordance with the Windows standards. 


The action editor in the Graphics Designer provides a similar range of functions to that of Global 
Script. A description of the Graphics Designer action editor is provided in the WinCC help topic 
"Dynamization". 


iia Global Script VBS - serv1.mcp: (Project Module) Module1.bmo 


eens ae seen | lb? 


“servi.mcp: (Project Module) Module1.bmo xX | 


EXstan... | Sacto... @ Cod... | vesiad 


= Proje 


<=} 


3) & = Project Modules Sub procedures 


=) {al Module1.bmo Dim myser 
§ procedures jset myser = HMIRuntime.Screens ("NewPdalis") 
[3] Module3.bmo myScr.FillStyle = 65536 


jEnd Sub 


a | Check of the procedure name... 


yx 


wana nn ane < \WWMWAREVS\WvinCC “Project serv1\ScriptLib\Module1.bmo = 
Syntax check... 
Creating procedure name list... 


; No errors occurred, 


Menu bar (1) and toolbars (2) 


All the commands required to create procedures and actions are provided in the menu bar and 
toolbars. 


The toolbars can be displayed and hidden using the "View" > "Toolbars" command and can 
be moved to any position within the editor. 
Navigation window (3) 


In the navigation window you manage your procedures, modules and actions. In addition you 
can find here code templates which you can insert by drag&drop into your action or procedure. 


A procedure can be called in another procedure or action by dragging them from the navigation 
window and dropping them at the relevant point in the code. 
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The display in the navigation window is always updated during the saving of the edited 
document. If you change a file, this will be displayed by a * behind the file name. 


The procedures contained in a module are displayed in the navigation window underneath the 
module file. The Actions tab control also displays the trigger and procedures configured for an 
action, if necessary those directly defined in an action module. 


The navigation window can still be used to: 
e Create subdirectories for structuring the scripts. 
@ Move, copy, paste, delete and rename modules and directories directly. 


The display in the navigation window can be individually configured with the "View" > 
"Workplace" menu commands. It is possible to select whether all file types, only script files or 
only syntactically correct files should be displayed. The navigation window can be shown or 
hidden with the "View" > "Workplace" > "Display" menu commands. 


Editing window (4) 


You write and edit your actions in the editing window. Each procedures or action will be opened 
in its own editing window. Several editing windows can be open at the same time. 


The user is supported by in the editing window by Highlight Syntax and Intellisense. All general 
editor functions (e.g. Undo/Redo, Find/Replace, Copy, Paste, Cut, Font Settings, Printer 
Settings) remain available. 

Output window (5) 

Error messages are displayed in the output window following the syntax check. Double click 
on the corresponding error line to access the related point in the code. 

Status bar (6) 


The status bar contains information on the currently selected functionality or hints on 
programming. 


Note 


If information on individual editor commands or icons is required, select the "?" menu icon. > 
"What's This?". Then click the mouse button on the corresponding icon/command. This 
provides fast, direct help on all the operating elements in the editors. Press "ESC" to exit 
"What's This?" help mode. 


Window docking 


Window docking is a useful tool for the flexible arrangement of windows. It lets you reposition 
windows to obtain separate windows, or group windows in tab groups. For example, you can 
arrange your actions horizontally, vertically, or as tab group. You can automatically hide 
windows and show them again when needed. 
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See also 
Deleting Actions or Procedures (Page 35) 
Working with the Toolbars (Page 33) 
Working in an Editing Window (Page 30) 
1.8.3 Working in an Editing Window 
Introduction 


Procedures and actions are edited in the editing window. 


Declaration Areas in Actions (Graphics Designer only) 


If you create actions in the Action Editor of Graphics Designer, you can display the declaration 
area of the action in the editing window using the button =. 


The declaration area can also be used to make general settings to be used globally for the 
current picture, e.g.: 


e Tag Definitions 


e@ Procedures which you only want to use in this picture 


Note 
Do not create any directly executable codes in the declaration area! 


Please note that when creating a tag, it must not contain a value (Value = VT_EMPTY). 
Initialize the tags after declaration with the corresponding value. 


When making definitions in the declaration area, pay attention to the structure of the Script 
files, as described under "Structure of VBScript files". 


"Option explicit" in Actions 


When creating a new action, the "Option explicit" instruction is automatically set and cannot 
be deleted in the declaration area (Graphics Designer) or entered in the first line of an action 
(Global Script). The instruction is necessary as it prevents errors caused by the incorrect 
notation of tags without declaration. The instruction requires that tags are always defined in 
your code with the "Dim" instruction. 


Note 


Do not use the "Option explicit" instruction in the code because it may cause Runtime errors. 


User Support in the Editing Window 


The following functions are available to support working in the editing window. 
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Color coding and indentation in the editing window 
Certain parts of the code have the following default colors: 


Color Description Example 

blue Key words Sub, End Sub, Next 
Functions 

green Comments ‘is a comment 

red Strings (character strings and "Object1" 
digits) 

dark blue Preprocessor statements -- 

bold black Constants vbTrue, vbFalse 

black Other codes -- 


The color coding in the editing window can be customized by means of the editor settings. 
Select the "Tools" > "Options" menu commands and the "Script Editor Options" dialog to define 
the settings. 


In order to organize the codes clearly, they can be structured by indentations. The "Script Editor 
Options" dialog can also be used to define the tabulator distance and Automatic Indent while 
writing. 


Intellisense and Highlight Syntax 


During text entry, context-sensitive lists appear containing the properties, methods, and objects 
possible at the current code position. If you insert an element from the list, the required syntax 
is also indicated automatically. 


Note 


Full intellisense for all objects can only be utilized in the Graphics Designer if the list is accessed 
using the object name and the result is assigned to a tag. Otherwise, only a list of standard 
properties is offered. 


Example of full intellisense: 
Dim Tag 


Set Variable = ScreenItems ("Kreisl") 


Tag. 


If picture window limits are exceeded during addressing, it is once again only the standard 
properties which are offered since the picture of the picture window is not loaded. 


Highlight Syntax can be activated and deactivated in the "Script Editor Options" dialog. The 
dialog can be called in using the "Tools" > "Options" menu commands. 

General VBS Functions 

Use the "Function List" command of the shortcut menu in the editing window to display a list 
of general VBS functions. 

Lists of Objects, Properties and Methods 


Using the shortcut menu in the editing window, you can view a list of the possible objects by 
calling the "Object List" command in Graphics Designer. Global Script only provides the 
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See also 
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"HMIRuntime" object in this list because there is no direct access to the objects of Graphics 
Designer. 


Use the "Properties/Methods" command of the shortcut menu to call in a list of possible 
properties and methods. 


The same lists can be called in with the key combination <CTRL + SPACEBAR?> according to 
the context of the script. 
Code Templates 


In the "Code templates" tab in the Navigation window of the Editor, you will find a selection of 
frequently used instructions, e.g., for loops and conditional instructions. The templates can be 
inserted in the procedure code with "drag-and-drop". 


If you want to insert a code template into your code, you have to replace the "_XYZ_" 
placeholder in the templates with the respective data. 
Selection Dialogs 


If WinCC tags or objects are used in the code, the following selection dialogs are available for 
use: 


e | Opens a tag selection dialog and returns the selected tag name as the return value. 
e (Opens a tag selection dialog and returns the tag name with an associated reference. 


e ig Opens a picture/object browser in which you can select a picture/object whose name is 
then used for the return value. 


e 4 Opens a picture selection dialog for pictures and returns the picture name with the server 
prefix, if necessary. 

Bookmarks 

Bookmarks can be set in the code to find certain parts in the code more easily: 

e /» Sets a bookmark in the line where the cursor is currently located. 

e 7% Deletes all bookmarks in the active editing window. 

e /* Jumps ahead to the next bookmark in the code. 


e /» Jumps back to the last bookmark in the code. 


Structure of VBScript Files (Page 92) 
Global Script Editor (Page 27) 
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1.8.4 Working with the Toolbars 


Purpose 


In their default position, the toolbars are located below the menu bar, at the top of the VBS 
editor. The buttons arranged on the toolbars enable quick, easy access to the functions 
provided in Global Script and the action editor in Graphics Designer. 


Global Script/Graphics Designer provide the following toolbars: 


"Standard" toolbar 


Button Function Key combination 

J Creates a new project module (Global Script only) <ALT+F1> 

FE) Creates a new standard module (Global Script only) <ALT+F2> 

= Creates a new global action (Global Script only) <ALT+F3> 

er] Opens an existing action or existing module (Global Script only) <CTRL+O> 

iA Saves the content of the active editing window. This function is only available if | <CTRL+S> 
an editing window is open. After saving the display in the navigation window is 
refreshed. (Global Script only) 

4 Prints the contents of the active editing window as project documentation. This | <CTRL+P> 
function is only available if an editing window is open. 

% Cuts the selected text and copies it to the clipboard. This function is only available | <CTRL+X> 
if text has been selected. 

a Copies the selected text to the clipboard. This function is only available if text | <CTRL+C> 
has been selected. 

res Pastes the contents of the clipboard at the location of the cursor. This function | <CTRL+V> 
is only available if the clipboard is not empty. 

“) Undoes the last of a maximum of 30 editor actions. This function is only available | <CTRL+Z> 
if an editor action has been executed. 

el Redoes the last editor action that was undone. This function is only available if | <CTRL+Y> 
an editor action has been undone. 

h? Activates the direct help F1 


Button Function Key combination 


+s Indents the line, in which the cursor is located, one position to the right. -- 


+= Indents the line, in which the cursor is located, one position to the left. -- 


= Marks the lines selected by the mouse as comments. If no lines have been -- 
selected by the mouse, the line in which the cursor is located is marked as a 
comment. 
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Button Function Key combination 
= Removes the comment marking from the lines selected by the mouse. If no lines | -- 
have been selected by the mouse, the comment marking in the line in which the 
cursor is located is removed. 
iia Sets a bookmarks in the current line. Actuating again removed the bookmark =| <CTRL+F9> 
from the current line. 
*y Removes all bookmarks from the current code in the editing window. <CTRL+SHIFT+F9> 
f/m Moves the cursor one bookmark further. <F9> 
/» Moves the cursor one bookmark back. <SHIFT+F9> 
ET Opens the "Find" dialog for text search in the code. <CTRL+F> 
Ac Opens the "Replace" dialog for search and replace in the code. <CTRL+H> 
ini Repeats the search process. <F3> 
? Opens the "Script editor options" dialog. - 


Content of the "Edit" Toolbar 


Button Function Key combination 
oc Selects the file in the navigation window to which the current editing window be- | -- 
longs (Global Script only). 
a Displays all the files in the navigation window (Global Script only). -- 
a Only displays the Script files in the navigation window (Global Script only). -- 
sy Only displays the syntactically correct files in the navigation window (Global Script | -- 
only). 
a Executes a Syntax Check in the code of the current editing window. <F7> 
go Opens a tag selection dialog returns the selected tag name as the return value. | <CTRL+U> 
(#] Opens a tag selection dialog and returns the tag name with an associated refer- | <CTRL+W> 
ence. 
Ke Opens a picture/object browser in which a picture/object can be selected whose | <CTRL+Q> 
name is then used for the return value. 
A Opens a picture selection dialog for pictures and returns the picture name, with | <CTRL+B> 
the server prefix if necessary. 
ic) Opens the "Info/Trigger" dialog. <CTRL+T> 
Additional Buttons in Graphics Designer 
In addition to the buttons provided by Global Script, the action editor in Graphics Designer also 
has the following buttons: 
e = Displaying the declaration area (<CTRL+E>) 
e = Hiding the declaration area (<CTRL+A>) 
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See also 
Global Script Editor (Page 27) 

1.8.5 Deleting Actions or Procedures 

Introduction 
If an action, procedure or a module is deleted in a script editor, the code and corresponding 
file are deleted in the project directory. 
Be careful only to delete procedures which are no longer used in other procedures or actions. 
If an action attempts to call in a procedure which no longer exists, the action is stopped in 
Runtime at the fault point. A non-existing reference in the code is not detected by the syntax 
check. 
Note 
Procedures can only be deleted within a module by deleting the code, not in the editor's 
navigation window. 

Procedure 
1. Open Global Script. 
2. Select the action or module to be deleted in the navigation window. 
3. Select the "Delete" command from the context menu. 
4. To delete a procedure: Open the relevant module and delete the corresponding code in 

the editing window. 
See also 


Actions (Page 18) 
Modules and Procedures (Page 15) 
Global Script Editor (Page 27) 
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1.9 Creating and Editing Procedures 
1.9.1 Creating and Editing Procedures 
Introduction 


Projects and standard procedures can be programmed in WinCC using VBS: 


@ Project procedures can only be retrieved in the current project. Since procedures are stored 
in the project directory, they are automatically copied when a project is copied. 


e@ Standard procedures can be called in by all computers linked to a project. When a project 
is copied onto another computer, the standard procedures must be copied into the 
corresponding directory on the target computer manually. 


The copied procedures are directly available for use in Runtime. The become visible in the 
editor when the view is updated. 


Apart from the procedures programmed by yourself, general VBS functions can also be used 
(e.g. Abs, Array,... Year). These general VBS functions can be invoked in the code using the 
"Function List" command from the context menu. 


In addition, WinCC provides the most popular instructions as code templates (e.g. If... Then, 
When...While). The code templates can be moved from the navigation window's Code 
Templates tab control directly into your code via drag&drop. 


If you insert a code template into your code, it is important to note that, for example, conditions 
in the templates are identified by "_XYZ_". You must replace these placeholders with the 
appropriate information. 


Using Procedures 


Procedures are used for the central creation and maintenance of codes which are to be 
implemented at several point in the configuration. Codes are written and saved in a procedure 
and the procedure is called in with the current parameters in actions or other procedures 
instead of repeatedly entering the same code. 


Create procedures for repeated functionalities, e.g. 

e Calculations with different starting values (procedure with return value) 

e Checking tag values (procedure with return value) 

e Executing tasks (procedure with return value) 

This is linked to the following advantages: 

e The code is only programmed once. 

@ Modifications are only made at one point, namely in the procedure, not in each action. 
e The action code is shorter and, thus, remains clearer. 


Related procedures should be stored in modules in WinCC. 
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Action A Action B Action C Action D 
Instruction1 Instruction1 InstructionA InstructionA 
Instruction2 Instruction2 InstructionB InstructionB 
Instruction3 Instruction3 Instruction? InstructionC 


MyModule 


MyProcedure1 
Instruction1 
Instruction2 
Instruction3 


MyProcedure2 
InstructionA 
InstructionB 
InstructionC 


Action A Action B Action C Action D 
MyProcedure1 MyProcedure1 MyProcedure2 MyProcedure2 


Procedures are loaded in Runtime when the calling action is executed. 


If a procedure (module) used in a picture is modified, the modification is applied the next time 
the picture is loaded. This means that a picture currently displayed only works with the modified 
procedure after the picture has been reloaded. 


After having a changed project module and saved the file in the VBS Editor, you must also 
open and save the corresponding process picture in Graphics Designer. You changes are not 
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activated in Runtime unless you completed this action. By saving the the picture, you activate 
the information in the picture file by means of the necessary project modules. 


Note 
Procedures can be used in actions in Global Script and Graphics Designer. 


In order to use a global tag defined in Global Script in an action in Graphics Designer, observe 
the following: 


In order that access can be made to the tag, it is necessary to call in the procedure in which 
the tag is defined. 


In order to use a global tag in picture-independent actions in Global Script, observe the 
following: 


In order that access can be made to the tag, at least one procedure in the module containing 
the tag must be called in at least one global action. 


Procedure - Action Restrictions 


Global procedures valid for the entire project can only be created in Global Script. Graphics 
Designer can only be used to create picture-specific procedures and call in global procedures 
in actions. Picture-specific procedures in Graphics Designer are defined in the declaration area 
of an action. 


A procedure is not executed without an action. 


File Name and Procedure Name 


The procedure name is entered in the first line of the procedure code. The procedure is 
displayed in the navigation window and called in actions under this name. Procedures do not 
have a file name of their own but are stored in a module. 


Module names are assigned in the editor's navigation window. Use the "Save As" command 
to save a module under another name in the project directory. 


Since procedures in Global Script are valid for the entire project, procedure names must always 
be unique. Module names can be used more than once within a project, e.g. in different 
subdirectories or stored separately in the standard and project directories. 


Displaying Procedures and Modules 
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%4 If you save a module that contains at least one syntactically incorrect procedure, this will 
be displayed in the navigation window with this adjacent symbol. 


Note 


If a module contains a syntactically incorrect procedure, the module can no longer be loaded. 
Procedures can no longer be called from the module. 


(a) If you save a module that contains only syntactically incorrect procedures, this will be 
displayed in the navigation window with this adjacent symbol. 
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Procedures and Modules 


Procedures are classified as standard or project procedures according to their assignment to 
standard or project modules. Standard and project modules are located o the corresponding 
tab controls in the Global Script navigation window. 


Use the modules in order to compile procedures to practical function groups. Observe the 
following when structuring the modules and procedures: 


e The more modules that must be loaded when a picture is called in, the worse the 
performance in Runtime. 


e@ The larger a module, the more procedures are contained and, thus, the longer the loading 
time for the module. 


Organize the modules sensibly, e.g. a module with procedures for a specific system part/ 
picture. 


See also 
Multiple Use of Procedures and Actions (Page 20) 
Renaming a Procedure or Module (Page 50) 
Saving a Procedure (Page 48) 
Protecting a Module with a Password (Page 47) 
How to add module-related information (Page 45) 
Using Standard and Project Procedures (Page 44) 
How to Write Procedure Codes (Page 41) 
Creating a New Procedure (Page 39) 
Examples of VBScript (Page 823) 


Modules and Procedures (Page 15) 


1.9.2 Creating a New Procedure 


Introduction 
Standard projects and procedures can be programmed with Global Script in WinCC. 


The type of procedure is defined by the assignment to a project or standard module. The 
procedure to create standard or project procedures is identical. 


On creating a new procedure, WinCC automatically assigns a standard name "procedure#", 
in which case # represents a continuos number. If the procedure is edited in the editing window, 
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Procedure 
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assign the procedure a corresponding name via which the procedure can be called in an action 
later. The name appears in the navigation window when the procedure is saved. 


Note 


Procedure names must be unique within a project. If a procedure with the same name already 
exists, the module is identified as syntactically incorrect. Module names can be used twice 
when the modules are stored in different directories. 


Global procedures (valid for the for entire project) can only be programmed Global Script. 
Procedures can be called via actions in Graphics Designer and picture-related procedures 
created in the declaration area of an action. Using a global action in Global Script, itis possible 
to create procedures directly in the code which are then only applicable for this action. 


An action must be programmed in order to call in a procedure. 


Th Workplace vy 2X - servi.mcp: (Project Module) Modulel.bmo xX Vv 


ESPro... /23Sta...| Bact... @ Co...) 
= © Project Modules 

SJ Module1.bmo 
4 procedures 


' Seript—-Module 
Sub procedureS (parameter1) 


End Sub be created. 


ands "File" > "New" 
New Procedure 


> = 


Procedure Declaration: 


ut return value is 


code: Sub "Procedure name". 


| proceduret 
odule: Select the module in the navigation window 
ure" context menu item. 


a: 


7. Enter a procedure name and select whether the procedure should have a return value 


parameter. The definition of a tag for the return value is then entered in the code (Dim 
RetVal). 


8. Confirm your settings with OK. 


eri 


Note 


A new procedure can also be entered directly in a module. In the case of procedures without 
return value, always begin with the instruction "Sub " and <Procedure Name> and conclude 
with "End Sub". In the case of procedures with return value, always begin with the instruction 
"Function " and <Procedure Name> and conclude with "End Function". The new procedure is 
displayed in the navigation window when the module is saved. 
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See also 
Creating and Editing Procedures (Page 36) 
Multiple Use of Procedures and Actions (Page 20) 
Renaming a Procedure or Module (Page 50) 
Saving a Procedure (Page 48) 
Protecting a Module with a Password (Page 47) 
How to add module-related information (Page 45) 
Using Standard and Project Procedures (Page 44) 
How to Write Procedure Codes (Page 41) 


Modules and Procedures (Page 15) 


1.9.3 How to Write Procedure Codes 


Introduction 


Procedure codes are written in the Global Script editor window. The code of each procedure 
can call in other procedures via their procedure names. 


Procedures can be created with or without return values. Use the return value to receive 
information about successful execution of the procedure, for example. 


If you modify a procedure in a picture, the modification will not take effect until the next time 
you load the picture. 


Functions in Global Script 


Global Script provides the following functions to support the creation of procedure codes: 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 41 


VBS for Creating Procedures and Actions 


7.9 Creating and Editing Procedures 


42 


Intellisense and Highlight Syntax 


During text entry, context-sensitive lists appear containing the properties, methods, and objects 
possible at the current code position. If you insert an element from the list, the required syntax 
is also entered automatically. 


Note 


Full intellisense for all objects can only be utilized in the Graphics Designer if the list is accessed 
using the object name and the result is assigned to a tag. Otherwise, you are only offered a 
list of standard properties. 


Example of a full intellisense: 


Dim Variable 
Set Variable = ScreenItems ("Circlel") 


Variable.<Intellisense selection> 


If picture window limits are exceeded during addressing, it is once again only the standard 
properties which are offered since the picture of the picture window is not loaded. 


General VBS Functions 

Use the "Function List" command of the shortcut menu in the editing window to display a list 
of general VBS functions. 

Lists of Objects, Properties and Methods 


Using the shortcut menu in the editing window, you can view a list of the possible objects by 
calling the "Object List" command in Graphics Designer. Global Script provides only the 
"HMIRuntime" object in this list because there is no direct access to the objects of Graphics 
Designer. 


Use the "Properties/Methods" command of the shortcut menu to call a list of possible properties 
and methods. 


The same lists can be called in with the key combination <CTRL + SPACEBAR?> according to 
the context of the script. 
Code Templates 


In the "Code templates" tab in the Navigation window of the Editor, you will find a selection of 
frequently used instructions, e.g. for loops and conditional instructions. The templates can be 
inserted in the procedure code with "drag-and-drop". 


If you want to insert a code template into your code, you have to replace the "_XYZ_" 
placeholder in the templates with the respective data. 
Selection Dialogs 


If WinCC tags or WinCC objects are used in the code, the following selection dialogs are 
available for use: 


e (| Opens a tag selection dialog and returns the selected tag name as the return value. 


e (Opens a tag selection dialog and returns the tag name with an associated reference. 
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© jm Opens a picture/object browser in which a picture/object can be selected whose name 
is then used for the return value. 


e  Opensa picture selection dialog for pictures and returns the picture name, with the server 
prefix if necessary. 
Syntax Check 


Global Script supports you with a syntax check which you can perform after the code has been 
created. Syntax errors in the code are displayed in the output window of the editor. You can 
move to the erroneous point in the code by double-clicking the error in the output window. 


Note 


The syntax check can only detect syntax errors in the code. Programming errors, such as 
missing references, only become visible in Runtime. You should therefore also always check 
your scripts in the Runtime environment. 


Changing a Procedure 


If a procedure is modified during Runtime, the modification becomes active at the following 
times: 


e Procedures called from actions or other procedures in pictures become active following a 
picture change. 


e Procedures in Global Script become active directly after being called again. 


Procedure 
1. Open Global Script. 
2. Open the module containing the procedure to be edited. 


3. After double clicking on the procedure in the navigation window, the cursor skips to the 
beginning of the required procedure. 


4. Edit the procedure. If you create a procedure with a return parameter, e.g. to program 
recurring evaluations or reviews, indicate the return value with "procedurename = RetVal" 
at the end of the procedure. 


See also 
How to Write Procedure Codes (Page 41) 
Multiple Use of Procedures and Actions (Page 20) 
Renaming a Procedure or Module (Page 50) 
Saving a Procedure (Page 48) 
Protecting a Module with a Password (Page 47) 
How to add module-related information (Page 45) 


Creating a New Procedure (Page 39) 
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1.9.4 


Introduction 


Modules and Procedures (Page 15) 


Creating and Editing Procedures (Page 36) 


Using Standard and Project Procedures 


Use the drag&drop function in the navigation window or the context menu to insert a procedure 
in the current code. 


Project procedures can only be used within the current project, standard procedures are 
available for all projects on the computer. 


Procedures, once created, can be used in other projects or on other computers. To do this, 
copy the module containing the procedures in the appropriate project or standard directory. 


Using Procedures in Graphics Designer and Global Script 


Procedure 


44 


Procedures defined in Global Script can be called in actions in Global Script and Graphics 
Designer. On executing the action in Runtime, the entire module which contains the procedure 
is loaded. 


Please observe the following in order to use a global tag defined in a procedure in Global 
Script: 


When using Graphics Designer, always call the procedure in which the tag is defined so that 
the tag can be used. | the procedure is not called in, the corresponding module is not loaded 
and access cannot be made to the tag. 


Inthe case of picture-independent actions in Global Script, at least one procedure in the module 
containing the tag must be called in at least one global action. 


Note 


In the general declaration part of screens, no check is made whether a procedure or function 
name has already been assigned. Therefore, a name could occur several times and it is not 
defined which function will be executed. This is standard behavior of the MS Scripting Engine. 


1. Open the procedure or action in which the procedure should be inserted. 


2. Use the drag&drop function to move the procedure to be inserted from the navigation 
window to the correct position in the code. 
or 


3. Place the cursor at the position in the code where you would like to insert teh procedure. 
4. Mark the procedure in the navigation window with the mouse. 


5. Choose pop-up menu command "Transfer Procedure Retrieval". 
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See also 
Creating and Editing Procedures (Page 36) 
Multiple Use of Procedures and Actions (Page 20) 
Renaming a Procedure or Module (Page 50) 
Saving a Procedure (Page 48) 
Protecting a Module with a Password (Page 47) 
How to add module-related information (Page 45) 
How to Write Procedure Codes (Page 41) 
Creating a New Procedure (Page 39) 
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1.9.5 How to add module-related information 


Introduction 


Related information can be added to each module in order to quickly recognize the functionality 
of the module or the procedures contained in it when edited at a later date. If several operators 
are involved in configuring a project, you should provide module-related information for your 
colleagues. 


When a new module is created, the creation date is entered in the module-related information 
automatically and is unchangeable. The Module is also assigned the version number 1.0. The 
version numbers can be individually assigned when editing a module. When a module is 

changed and saved, the current date of change is entered automatically and is unchangeable. 


The following information can be added: 

e "Created by" 

e "Changed by" 

¢ "Comments" e.g. module functionality/procedures contained 


It is still possible to define a password for the module. Further information on assigning 
passwords is provided in "Protecting Modules with a Password". 
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See also 
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1. Open Global Script. 


2. Select the module in which information is to be added in the navigation window. 


3. “4 Click the "Info/Trigger" toolbar button, or select the "Info" menu command. The 
"Properties..." dialog appears. 


Properties g 


Info 


Created by: 

Creation date: 30 10 2012 
Changed by: 

Date of change: 9 11 2012 


Enter the required information. 


Note 


The "Info/Trigger" dialog can also be called if an open procedure is selected in the navigation 
window. The information stored in this dialog is always valid for the entire module and all the 
procedures contained in it. 


Multiple Use of Procedures and Actions (Page 20) 
Renaming a Procedure or Module (Page 50) 
Saving a Procedure (Page 48) 

How to add module-related information (Page 45) 
Using Standard and Project Procedures (Page 44) 
How to Write Procedure Codes (Page 41) 
Creating a New Procedure (Page 39) 
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Modules and Procedures (Page 15) 


Creating and Editing Procedures (Page 36) 


1.9.6 Protecting a Module with a Password 


Introduction 


A module can be assigned a password to protect it from unauthorized access. The password 
is a part of the module-related information. 


Note 


If a module is protected by a password, all the procedures contained in it are also protected 
by the password. 


Procedure 
1. Open Global Script. 
2. Select the module to be assigned a password in the navigation window. 


3. “4 Click the button "Info/Trigger" in the toolbar or choose the pop-up menu command "Info". 
The "Properties..." dialog appears. 


4. Activate the check box "Password". 
The dialog "Enter Password" is displayed. 


5. Enter a password and confirm it. 


6. Confirm your settings with OK. 


Result 

If an attempt is made to open the module or a procedure contained in it, a prompt appears 
requesting the password. 

Deactivate Password Protection 

To clear the password protection, disable the "Password" check box. 


Change Password 


To change the password, open in the Properties dialog and click the "Change" button. Then 
enter the new password. 


Note 


If you forget the module password, the module cannot be edited. 
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See also 


1.9.7 


Introduction 
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Note 


The "Info/Trigger" dialog can also be called if an open procedure is selected in the navigation 
window. The information stored in this dialog is always valid for the entire module and all the 
procedures contained in it. 


Multiple Use of Procedures and Actions (Page 20) 
Renaming a Procedure or Module (Page 50) 
Saving a Procedure (Page 48) 

How to add module-related information (Page 45) 
Using Standard and Project Procedures (Page 44) 
How to Write Procedure Codes (Page 41) 
Creating a New Procedure (Page 39) 

Modules and Procedures (Page 15) 
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Saving a Procedure 


Individual procedures are never stored but the module in which the procedure has been 
programmed. 


Before saving a module, check the code is syntactically correct. When saving a module, the 
procedures contained are automatically checked and, in the case of syntax errors, a prompt 
appears as to whether the module should be saved with the errors or not. In this way, for 
example, modules and procedures can be saved which are not fully programmed. Syntactically 
incorrect procedures do not run in Runtime. 


Note 


If a module contains a syntactically incorrect procedure, the module can no longer be loaded. 
Procedures can no longer be called from the module. 
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Requirement 


Procedure 


See also 


7.9 Creating and Editing Procedures 


Note 


The syntax check can only detect syntax errors in the code. Programming errors, such as 
missing references, only become visible in Runtime. Therefore, always check the scripts in 
the Runtime environment and use a debugger, if necessary, to detect and eliminate errors. 


Only syntactically correct modules are called in Runtime. 


A list of all the possible syntax errors is available in the Appendix under " Basic Principles of 
VBScript". 


@ 


If a procedure is subjected to a syntax check prior to saving, any errors are displayed in the 
lower part of the editor window. Double click on an error line to access the error position in the 
code directly. 


‘3 


Use the "Save As" command to store the module under another name. Note that the new 
module is only displayed in the navigation window after updating the view. 


The procedure/module to be saved must be open in the editor window. 


1. Click = in the toolbar. 


2. If syntax errors appear in the output window, double click on the error line and correct the 
error in the code. Repeat steps 1 and 2 until the code is correct. 


3. Save the module by clicking |, in the toolbar. 


Note 
Pictures with modified procedures must be opened and saved once again in Graphics Designer 


In addition to saving in the VBS editor, the corresponding picture must be opened and saved 
once again in Graphics Designer when the project module is changed. The change is then 
applied in Runtime. Only once the picture has been saved is the information applied to the 
picture file via the required project modules. 


Diagnostics (Page 80) 
Multiple Use of Procedures and Actions (Page 20) 
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Introduction 


Procedure 
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Saving a Procedure (Page 48) 

Protecting a Module with a Password (Page 47) 
How to add module-related information (Page 45) 
Using Standard and Project Procedures (Page 44) 
How to Write Procedure Codes (Page 41) 
Creating a New Procedure (Page 39) 

Modules and Procedures (Page 15) 
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Renaming a Procedure or Module 


Procedures and modules are renamed in the following cases: 


e When a standard name (procedure# or Modul#), which was automatically assigned when 
the new module/new procedure was created, is changed to a self-explanatory name. 


e@ When a module or procedure is copied in order, for example, to create a new module with 
similar content from an existing one. 
Please note that procedure names must be unique within a project. Procedure names which 
exist twice are issued as errors during the syntax check. 
Contrary to procedure names, the same name can be applied to modules when the modules 
are stored in different directories. 


Note 


The module name is always identical to the file name in the WinCC file system. If a module 
name is changed, e.g. in Windows Explorer, the new module name is taken over from Global 
Script in the navigation window. 


Renaming Procedures 
1. Open the procedure to be renamed. 
2. Enter the new name in the header of the procedure. 


3. Save the procedure so that the name is transferred to the navigation window. Procedure 
names are always unique and may not be used more than once. 
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Renaming Modules 
1. Close the module to be renamed. 


2. Select the module in the navigation window and choose the "Rename" option from the 
context menu. 


3. Enterthe new name in the navigation window. Module names are always unique at directory 
level and may not be used more than once. 


See also 
Multiple Use of Procedures and Actions (Page 20) 
Saving a Procedure (Page 48) 
Protecting a Module with a Password (Page 47) 
How to add module-related information (Page 45) 
Using Standard and Project Procedures (Page 44) 
How to Write Procedure Codes (Page 41) 
Creating a New Procedure (Page 39) 
Modules and Procedures (Page 15) 


Creating and Editing Procedures (Page 36) 
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1.10 Creating and Editing Actions 
1.10.1 Creating and Editing Actions 
Introduction 
When using VBS in WinCC, there is no differentiation between local (valid for entire project) 
and global (valid on all computers) actions, as opposed to C. A configured action is always 
valid globally. 
A copied action is available for use in Runtime following a restart or opening and saving the 
action. The become visible in the editor when the view is updated. 
VBS actions can be used in to make graphic objects and object properties dynamic in Runtime 
or to execute picture-independent actions. 
Note 
Please note that the object name length of objects made dynamic in Graphics Designer is 
limited to approx. 200 characters, and each special character used in an object name is 
converted to five characters in the script files. The special characters are represented by a 
four-place hexadecimal code behind the preceding X. If the name of an object made dynamic 
is too long, a corresponding error message appears. Further information is available in this 
help under "Structure of VBScript Files". 
Note 
If you make an object property dynamic with a VBS action via the return value of a script, the 
value of the object property is written only if it has changed in relation to the last script run. It 
is not considered if the value had been changed from another location. 
Therefore it is illegal to change properties which have been made dynamic by VBS action via 
the return value from another location (e.g., other C scripts or VBS scripts). 
if you do not observe this, wrong values can be the results. 
Using the Actions 
Actions can be used as follows: 
On graphic objects in Graphics Designer 
Making properties dynamic (action with return value), e.g.: 
Function BackColor Trigger (ByVal Item) 
"VBS143 
BackColor Trigger = RGB(125,0,0) 
End Function 
Triggered by an event on an object (action without return value), e.g.: 
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Sub OnClick(ByVal Item) 
"VBS144 


Item.BackColor = RGB(255,0,0) 


End Sub 


Picture-independent in Global Script 
As a cyclic action, e.g. incrementing a tag: 


Option Explicit 

Function action 

"VBS145 
Dim objTagl 
Dim lngValue 
Set objTagl = HMIRuntime.Tags ("Tagl") 
ingValue = objTagl.Read 
objTagl.Write lngValue + 1 


action = CLng(objTagl.value) 


End Function 


Executing Actions 


An action can be assigned several triggers. The action is always executed when one of the 
triggering events occurs. Observe the following: 


e Actions in Global Script cannot be executed simultaneously. The action triggered last is 
held in a queue until the action currently being performed is completed. 


e When using Graphics Designer, cyclically and tag-driven actions cannot be triggered 
simultaneously. If the execution of a tag-driven action hinders the execution of a cyclic 
action, the cyclic action is executed when the tag-driven action has finished. The cyclic 
action is held in a queue during the non-execution phase. When the current action is 
completed, the cyclic action is executed with the normal cycle. 


e In Graphics Designer, event-driven actions cannot be executed simultaneously. 


The action types mentioned do not prevent each other being executed: The execution of 
actions in Global Script has no influence on actions in Graphics Designer. In the same way, 
in Graphics Designer, the execution of cyclically or tag-driven actions has no effect on the 
execution of event-driven actions. 


Note 


Actions in pictures which are still running one minute after the picture has been deselected 
are terminated by the system. This is recorded in a logfile entry. 
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Locating Actions 


All the actions used in a picture can be displayed by means of the picture properties. To do 
this mark the picture in WinCC Explorer and select the "Properties" context menu command. 
After double clicking on an entry, detailed information on the type of dynamics appears. 


It is also possible to display all the tags and pictures used in actions by means of the WinCC 
CrossReference. CrossReference can also be used for the to link tag connections of Graphics 
Designer actions easily. 


Note 


Use the standard formulations 

HM IRuntime.BaseScreenName = "Screenname" and HMIRuntime.Tags("Tagname") when 
addressing pictures and tags in your code in order to ensure that the pictures and tags are 
registered by the CrossReference. 


Procedure - Action Restrictions 


Actions can be used to program instructions and call procedures. Codes are programmed 
within in procedures for use at several points in a configuration. Contrary to procedures, actions 
always have a trigger. 


Module 


Procedure A 


Procedure B 


Procedure C 


Instruction-1 
Instruction-2 Instruction-a 
Procedure C Instruction-b 


Trigger 


Instruction-n 


Procedure D 
Procedure E 


Creating and Editing Actions 


Actions can be configured in Global Script and Graphics Designer. Use Global Script to 
configure global actions which can be executed independently of the picture currently open. 
Graphics Designer is used to configure actions related to graphic objects which should be 
executed when the picture is opened in Runtime or when the configured trigger occurs. 
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The script editors in WinCC provide the option of checking that scripts have a correct syntax 
without executing them. Errors in the script are displayed in the output window under the editor 
window. Double click on the corresponding error line to access the related point in the code. 


Note 


The syntax check can only check objects known to the system at the moment of execution. 
Therefore, the tags and objects addressed in the scripts must be created in WinCC. 


Only syntactically correct actions are executed in Runtime. 


The automation objects "PDLRuntime" and "WinCC Runtime Project" cannot be used in VBS 
actions. 


Display of Actions 


Wilf you save a syntactically incorrect action, it will be displayed in the navigation window with 
this adjacent symbol. 


Alf you save a syntactically correct action without trigger, it will be displayed in the Global 
Script navigation window with this adjacent symbol. 


oy If you save a syntactically correct action with trigger, it will be displayed in the Global Script 
navigation window with this adjacent symbol. 


Note 


Actions can only be saved in the Graphics Designer if they have the correct syntax. If an action 
with errors should still be retained and exited, however, enter the comments. 


System behavior if actions are changed, deleted and saved at Runtime 


See also 


If a local action is stored at runtime, then all local and global actions of the computer are reset 
on the computer to which the local action belongs. 


If a global action is stored during runtime, then all local and global actions for the entire project 
— and thus on all computers — are reset. 


Such a reset might reinitialize for examples tags and times that are used as triggers for actions, 
triggering the action at that stage. 


Static tags used in the reset actions are reinitialized. 


Structure of VBScript Files (Page 92) 

Action and Procedure Names in the Debugger (Page 94) 
How to Rename an Action (Page 76) 

Saving Actions (Page 63) 


Protecting an Action with a Password (Page 62) 
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1.10.2 


Introduction 


Procedure 
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How to add action-related information (Page 60) 
How to Edit Actions (Page 57) 

Creating a New Action (Page 56) 

Triggers (Page 64) 

Actions (Page 18) 


Creating a New Action 


When a new action is created, the editor automatically suggests a file name (Action#.bac), 
which can be changed. 


Actions can be configured in Global Script and Graphics Designer. 


@ Global Script is used to configure actions which can be executed, picture-independently, 
in Runtime. Open Global Script via WinCC Explorer. 


@ Graphics Designer is used to configure a new action, related to the properties of a graphic 
object, by clicking on the right mouse button in the "Dynamic" column of the Properties tab 
control and selecting VBS Action. An action, related to an event, is created in the same 
way using the Events tab control. 

In both cases, the Action Editor of the Graphics Designer opens. 


Note 


The precise procedure for linking actions with graphic objects is described under the WinCC 
help topic "Dynamics". 


1. Open Global Script. 
2. Activating the Actions Tab Control in the Navigation Window. 


3. Click :4 in the toolbar or choose the menu command "File" > "New" > "Action". 
A new action is opened in the editor window. The action appears in the navigation window 
after it has been saved. 


Note 


When creating a new action, the "Option explicit" instruction is automatically entered in the 
declaration area and cannot be deleted. The instruction is necessary as it prevents errors 
caused by the incorrect notation of tags without declaration. 


The instruction requires that tags are always defined in your code with the "Dim" instruction. 


Do not use the "Option explicit" instruction in the code because it may cause Runtime errors. 
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How to Rename an Action (Page 76) 

Saving Actions (Page 63) 

Protecting an Action with a Password (Page 62) 
How to add action-related information (Page 60) 
How to Edit Actions (Page 57) 

Triggers (Page 64) 

Creating and Editing Actions (Page 52) 

Actions (Page 18) 


How to Edit Actions 


An action is edited in the same way as a procedure in the editor window of the editor or in the 
Graphics Designer action editor. 


In order that an action can be executed in Runtime, it requires a trigger. Actions which are 
triggered by an event in Graphics Designer do not require the assignment of a trigger. 


If an action is modified during Runtime, the change is applied when the picture is reloaded (in 
the case of actions in Graphics Designer) or the next time the action is called (in the case of 
actions in Global Script). 


Note 


A change in the code in Runtime cannot be applied when another action is being carried out 
at the same time. 


A procedure call can be inserted in the action by dragging the procedure from the editor 
navigation window with "drag-and-drop" and dropping it in the corresponding position of the 
code in the editor window. C scripts cannot be called in VBS actions. 


Declaration Area in Actions 


If you create actions in Graphics Designer, you can display the declaration area of the action 
using the button = . When creating a new action, the "Option explicit" instruction is 
automatically entered in the declaration area and cannot be deleted. The instruction is 
necessary as it prevents errors caused by the incorrect notation of tags without declaration. 


The instruction requires that tags are always defined in your code with the "Dim" instruction. 


Do not use the instruction "Option explicit" in your code as this can cause Runtime errors. 
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In the declaration area, you can also make general settings which you want to use globally for 
the current picture, e.g.: 


e Tag Definitions 
e@ Procedures which you only want to use in this picture 


In the declaration area of the actions, you may define global tags independent of each other 
in the areas "Event" and "Properties" of an object. There is no link between global tags of 
identical names in both areas. 


Note 


Always make sure that the procedures in the declaration area have correct syntax, i.e. with 
"Sub" - "End Sub". Do not create directly executable codes in the declaration area as this can 
cause Runtime errors. 


If global tags are used in the declaration area of actions Graphics Designer, note that the event- 
driven and cyclic/tag-driven actions are processed separately in Runtime. There is no 
synchronization of global tags between the two Runtime systems in Runtime. If synchronization 
of tags is required, configure these using the DataSet object or internal WinCC tags. 


When making definitions in the declaration area, pay attention to the structure of the Script 
files, as described under "Structure of VBScript files". 


Functions for Editing Actions 
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The script editors provide the following functions to assist you in creating action code: 


Intellisense and Highlight Syntax 


During text entry, context-sensitive lists appear containing the properties, methods, and objects 
possible at the current code position. If you insert an element from the list, the required syntax 
is also indicated automatically. 


Note 


Full intellisense for all objects can only be utilized in the Graphics Designer if the list is accessed 
using the object name and the result is assigned to a tag. Otherwise, only a list of standard 
properties is offered. 


Example of full intellisense: 


Dim Variable 
Set Variable = Screenltems ("Circle1") 


Variable.<Intellisense> 


If picture window limits are exceeded during addressing, it is once again only the standard 
properties which are offered since the picture of the picture window is not loaded. 


General VBS Functions 


Use the "Function List" command of the shortcut menu in the editing window to display a list 
of general VBS functions. 
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Lists of Objects, Properties and Methods 


Using the shortcut menu in the editing window, you can view a list of the possible objects by 
calling the "Object List" command in Graphics Designer. Global Script only provides the 
"HMIRuntime" object in this list because there is no direct access to the objects of Graphics 
Designer. 


Use the "Properties/Methods" command of the shortcut menu to call in a list of possible 
properties and methods. 


The same lists can be called in with the key combination <CTRL + SPACEBAR> according to 
the context of the script. 


Code Templates 


In the "Code templates" tab in the Navigation window of the Editor, you will find a selection of 
frequently used instructions, e.g., for loops and conditional instructions. The templates can be 
inserted in the procedure code with "drag-and-drop". 


If you want to insert a code template into your code, you have to replace the "_XYZ_" 
placeholder in the templates with the respective data. 
Selection Dialogs 


If WinCC tags or WinCC objects are used in the code, the following selection dialogs are 
available for use: 


e (| Opens a tag selection dialog and returns the selected tag name as the return value. 
e (Opens a tag selection dialog and returns the tag name with an associated reference. 


© jm Opens a picture/object browser in which a picture/object can be selected whose name 
is then used for the return value. 


e Opens a picture selection dialog for pictures and returns the picture name with the server 
prefix, if necessary. 


Syntax Check 


Global Script supports you by providing a syntax check which you can perform after the code 
has been created. Syntax errors in the code are displayed in the output window of the editor. 
You can move to the erroneous point in the code directly by double-clicking the error in the 
output window. 


Note 


The syntax check can only detect syntax errors in the code. Programming errors, such as 
missing references, only become visible in Runtime. Therefore, always check the scripts in 
the Runtime environment and use a debugger, if necessary, to detect and eliminate errors. 
The way to test scripts with a debugger is described in this documentation under the topics 
"Diagnostics" > "Testing with the Debugger". 
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Procedure 


See also 


1.10.4 


Introduction 


60 


1. Open Global Script. 
2. Double click on the action on the Action tab control in the navigation window. 
3. Edit the action. 


Using Global Tags in VBS (Page 24 
Testing with the Debugger (Page 87 
Structure of VBScript Files (Page 92 


Seo rer lh 


How to Rename an Action (Page 76 


— 


Saving Actions (Page 63) 

Protecting an Action with a Password (Page 62) 
How to Edit Actions (Page 57) 

Creating a New Action (Page 56) 

Triggers (Page 64) 

Creating and Editing Actions (Page 52) 

Actions (Page 18) 


How to add action-related information 


Related information can be added to every action in Global Script in order that the function of 
an action can be recognized at a later date when editing. If several operators are involved in 
configuring a project, you should provide action-related information for your colleagues. 


When a new action is created, the creation date is entered in the action-related information 
automatically and is unchangeable. The action is also assigned version number 1.0. The 
version numbers can be individually assigned when editing an action. When an action is 
changed and saved, the current date of change is entered automatically and is unchangeable. 


The following information can be added: 
e "Created by" 
e "Changed by" 


e "Comments:" e.g. functionality of the action 
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Procedure 


See also 


7.10 Creating and Editing Actions 


It is also possible to define a password for the action. Further information on assigning 
passwords is provided in "Protecting Actions with a Password". 


Note 


Additional information can only be made available actions in Global Script, not for actions in 
Graphics Designer. 


1. Open Global Script. 
2. Open the action for which information should be added. 


3. © Click the "Info/Trigger" toolbar button, or select the "Info" menu command. The 
"Properties..." dialog appears. 


Properties [2 [mem] 


Info 


Created by: 

Creation date: 30 10 2012 
Changed by: 

Date of change: § 11 2012 


4. Enter your information. 


How to Rename an Action (Page 76) 

Saving Actions (Page 63) 

Protecting an Action with a Password (Page 62) 
How to Edit Actions (Page 57) 

Creating a New Action (Page 56) 

Triggers (Page 64) 
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1.10.5 


Introduction 


Procedure 


62 


Creating and Editing Actions (Page 52) 
Actions (Page 18) 


Protecting an Action with a Password 


An action in Global Script can be protected against unauthorized access by assigning a 
password to it. The password is a part of the action-related information. 


Note 


Only actions in Global Script can be assigned a password, not actions in Graphics Designer. 


1. Open Global Script. 


‘5 Open the action to be protected by a password. 


w 


Click the button "Info/Trigger" in the toolbar or choose the pop-up menu command "Info". 
The "Properties..." dialog appears. 


. Select the "Password" check box. 


4 
5. Click the "Change" button. The "Enter Password" window opens. 
6. Enter a password and confirm it. 

7 


. Confirm your settings with OK. 


Result 
If an attempt is made to open the action, the system requests the password is entered. 


Deactivate Password Protection 
To clear the password protection, disable the "Password" check box. 


Change Password 


To change the password, open in the Properties dialog and click the "Change" button. Then 
enter the new password. 


Note 


If you forget the action password, the action cannot be edited. 
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See also 


7.10 Creating and Editing Actions 


How to Rename an Action (Page 76) 

Saving Actions (Page 63) 

How to add action-related information (Page 60) 
How to Edit Actions (Page 57) 

Creating a New Action (Page 56) 

Triggers (Page 64) 

Creating and Editing Actions (Page 52) 

Actions (Page 18) 


1.10.6 Saving Actions 


Introduction 


Prior to Saving 


Before an action can be run in Runtime, it must be saved. Save an action as any other Windows 
file using the "File" > "Save" commands or the corresponding icon. 


Note 


Actions in Graphics Designer are automatically applied on closing the action editor with the 
picture. Functions can only be saved in the Graphics Designer if they have the correct syntax. 
If an action with errors should still be retained and exited, however, enter the comments. 


A list of all the possible syntax errors is available in the Appendix under " Basic Principles of 
VBScript". 


In order to save an action under a different name, e.g. to use an action as a basis for another 
action, use the "Save As" command. 


Note that, when using "Save As", only the file name is changed and not the action name. 


Before saving an action, check the code is syntactically correct. The syntax errors in the code 
are displayed in the output window of Global Script. Double click on an error line to access the 
error position in the code directly. 


Note 


The syntax check can only detect syntax errors in the code. Programming errors, such as 
missing references, only become visible in Runtime. Therefore, always check the scripts in 
the Runtime environment and use a debugger, if necessary, to detect and eliminate errors. 


If actions are saved without running a syntax check beforehand, the editor comments that a 
syntactically incorrect action will be saved which cannot subsequently be run in Runtime. 
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W Syntactically incorrect actions are displayed with the adjacent icon in the navigation window. 


Procedure 
1. Click = in the toolbar. 


2. If errors are displayed in the lower part of the editor window, double click on the error line 
and correct the error in the code. Repeat steps 1 and 2 until the code is correct. 


3. Save the action by clicking | in the toolbar. 


See also 
Actions (Page 18) 
How to Rename an Action (Page 76) 
Protecting an Action with a Password (Page 62) 
How to add action-related information (Page 60) 
How to Edit Actions (Page 57) 
Creating a New Action (Page 56) 
Triggers (Page 64) 
Creating and Editing Actions (Page 52) 


1.10.7 Triggers 


1.10.7.1 Triggers 


Definition and use 


Triggers are used to execute actions at Runtime. To do this, a trigger is linked to an action, 
forming the triggering event for calling the action. Actions without triggers will not be carried 
out. 


The triggers defined for an action are displayed in the Global Script navigation window . 


Workplace wax 


Pro... “sta... Bact... [@ Co...| 


© © actions 
i) oY CreateReport. bac 
§ action 
© EveryHour 
® OnceAtchristmas 
= §} GiveoutWarning.bac 
4 action 
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Trigger types 
The following trigger types are available: 


Acyclic triggers 


They consist of the specification of date and time. The action specified by such a trigger is 
performed once at the date and time specified. 


Cyclic triggers 


They consist of the specification of a time interval and start time. The following types of cyclic 
triggers are available: 


e Default cycle. The start of the first time interval coincides with the start of Runtime. The 
length of the interval is determined by the cycle. 


e Hourly. The start of the interval is specified as minute and second. The length of the interval 
is an hour. 


e Daily. The start of the interval is specified by the time (hour, minute and second) festgelegt. 
The length of the interval is a day. 


e Weekly. The start of the interval is specified by the day of the week (Monday, Tuesday, 
etc.) and the time. The length of the interval is a week. 


e Monthly. The start of the interval is specified by the day and time. The length of the interval 
is a month. 


e Annual. The start of the interval is specified by the day, month and time. The length of the 
interval is a year. 


Time-controlled triggers are used for actions Global Script and for actions to make graphic 
objects dynamic. 


Tag triggers 


They consist of one or more specified tags. The action associated with such a trigger is 
performed each time a change in the value of one of these tags is detected. 


How the tag values are queried may be customized for each tag. Select from the following 
modes: 


® Cyclic query of the tag value: Specify a standard cycle. The tag value is queried at the 
defined intervals (e.g. every 2 seconds). The action is triggered when the system detects 
a change of the tag value. 
Depending on the size of the cycle, it is possible that the tag value is changed but it is not 
detected by the system. 
If, for example, a cycle of 5 minutes has been set, the tag value may change several times 
within the 5 minute period but only the value set when the next query is made is detected. 
The value changes between the two queries are not registered. 


e Changes in the tag value: Each change in the tag value is detected by the system. The 
action is executed each time the tag value changes. 


Tag triggers are used for actions Global Script and for actions to make graphic objects dynamic. 
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Event-driven 


When an action is configured related to an event on a graphic object, the action is triggered 
when a specific event has occurred, e.g. following a mouse click or the change of the 
background color due to another action. 


Animation cycle 


As of WinCC V7.0, the "animation cycle" trigger art is available for the dynamization of objects 
with VBS. The animation cycle allows you to switch actions on and off in Runtime and to change 
the time, in which the trigger is executed. 


You can find additional information in the "AUTOHOTSPOT" section. 


Effects of triggers on actions 


If the action is associated with only one trigger, then the action is performed as soon as the 
triggering event occurs. 


However, an action may be associated with multiple triggers, such as a cyclic trigger and a 
tag trigger. Here the action is performed whenever one of the two triggering events occurs. If 
two events occur simultaneously, then the action is executed twice sequentially. If two tag 
triggers fire at the same time, the action will be performed only once. 


Processing actions in Graphics Designer 
The following rules apply to processing actions in Graphics Designer: 
e No event-driven actions can be executed as long as another event-driven action is running. 


e No cyclic/tag triggered actions can be executed as long as another cyclic/tag triggered 
action is running. 


e The two action types do not affect each other: An event-driven action can also be executed 
when a cyclic action is already in progress. 


e Ifthe execution of actions is blocked by other actions (e€.g. a cyclic action by a tag-triggered 
action), each action which is blocked is executed once at the next possible moment. Cyclic 
actions then run in their normal intervals after the one-off execution. 


Processing actions in Global Script 


Picture-based actions from Global Script are executed in Runtime in succession after being 
triggered. When an action is triggered while another action is in progress, the second action 
is kept in a queue until it can be executed. 


Actions in Global Script and Graphics Designer do not affect each other. 


Note 


If the action should not be executed at each event, it is possible to define a condition in the 
action, the result of which controls whether the action is executed or not. 
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Notes on configuring triggers 


Depending on the system, it cannot be guaranteed that an action with a cyclic trigger will be 
carried out at exactly the specified time. If this is a requirement, then the task (such as a check) 
should be implemented on the automation device. 


The tag triggers should have priority over cyclic triggers: With cyclic actions, the action is 
always executed, e.g. every 20 seconds. The tag trigger only executes the action if a change 
in the value of the tag has been detected in the case of cyclic queries. This reduces the load 
on the system and increases performance. 


Trigger tag Cyclical trigger 


- £ ££ & & TH 


Trigger tag Tag trigger 


F F F Time 

If a tag trigger is used, configure the "Upon Change" cycle to start as seldom as possible. This 
query cycle causes the tag to trigger the action following every change. This causes high 
system loads. 


Linking tag triggers 


The CrossReference from WinCC can be used to quickly find all the application points of tags, 
even in VBS actions. Tag triggers in actions in Graphics Designer can be "linked" using 
CrossReference, i.e. replaced by other tags at all or selected points. 


Note 


Tags can also be directly linked in Graphics Designer by marking the graphic object and 
selecting the "Linking ..." command from the context menu. 


Use the standard formulations 

HMIRuntime.BaseScreenName = "Screenname" and 

HMIRuntime.Tags ("Tagname") when addressing pictures and tags in your code in order 
to ensure that the pictures and tags are registered by the CrossReference. 


Further information on CrossReference is available in the WinCC documentation. 
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See also 
Actions (Page 18) 
How to delete a trigger (Page 75) 
How to change a trigger (Page 74) 
How to add a trigger of the type "Tag" (Page 72) 
How to add a trigger of the type "Timer" (Page 70) 
Creating and Editing Actions (Page 52) 


1.10.7.2 Animation trigger 


Introduction 


As of WinCC V7.0, the "animation cycle" trigger art is available for the dynamization of objects 
with VBS. The animation cycle allows you to switch actions on and off in Runtime and to change 
the time in which the trigger is executed. 


Animation cycles 


CycleTime125ms CycleUser1 User cycle 1 
CycleTime250ms 250 ms CycleUser2 User cycle 2 
CycleTime500ms 500 ms CycleUser3 User cycle 3 
CycleTime1s 1s CycleUser4 User cycle 4 
CycleTime2s 2s CycleUser5 User cycle 5 
CycleTime5s 5s CyclePicture Picture cycle 
CycleTime10s 10s CycleWindow Window Cycle 
CycleTime1min 1 min 

CycleTime5min 5 min 

CycleTime10min 10 min 

CycleTimeth 1h 


You use the trigger by writing an action and using the "animation cycle" trigger type. This action 
can be activated or deactivated in Runtime with the "ActivateDynamic" and 
"DeactivateDynamic" methods. The methods are described in the VBS reference of the WinCC 
Information System. The correct syntax of the methods deviates from the description in the 
VBS reference and is shown in the following two examples. 


Example 


With an action at the determined property "Position X" (left), the rectangle is shifted 5 pixels 
to the right. Select the "animation cycle" event in the action as the trigger. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
68 System Manual, 02/2016, A5E37536061-AA 


VBS for Creating Procedures and Actions 


7.10 Creating and Editing Actions 


Enter the following as action in the "Left" property: 


item.Left = item.Left + 5 


You can switch the action on and off at the property "Position X" with the following methods. 


The trigger is switched on in Runtime with the "ActivateDynamic" method: 


Dim obj 
Set obj = ScreenItems.Item("Rectanglel") 


obj.ActivateDynamic "Left", "CycleTimels" 


The trigger is switched off in Runtime with the "DeactivateDynamic" method: 


Dim obj 
Set obj = ScreenItems.Item("Rectanglel") 


obj.DeactivateDynamic "Left" 


Note 


The WinCC tags remain requested even when the trigger is switched off. 


See also 
ActivateDynamic method (Page 713) 
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1.10.7.3 How to add a trigger of the type "Timer" 


Introduction 


"Timer" type triggers execute an action at a certain time. "Timer" type triggers can be cyclic or 
acyclic triggers. 


e Acyclic triggers Trigger an action once at the configured time. 


® Cyclic triggers Trigger an action at regular intervals. The time interval and start time for the 
time must be triggered. If a standard cycle is selected as the cyclic trigger, the start time is 
always the start of Runtime. User-specific cycles can also be selected as standard cycles. 


Note 


Cyclic triggers guarantee a high updating rate of the system but require high system loads. 
Choose cyclic triggers only for those actions, where the update is very important. 
With high system loads, some actions may not be executable. 


"Timer" type triggers are used to make the properties in Graphics Designer dynamic and 
execute global actions. 


Procedure 
1. Open the action. 


2. ‘4 Click the button "Info/Trigger" in the toolbar or choose the pop-up menu command "Info". 
The "Properties..." dialog appears. 


3. Select the "Triggers" tab. 
4. Select the "Timer" trigger and then select the trigger type to be created: cyclic or acyclic. 
5. Click on the "Add" button. The "Add Trigger" dialog appears. 
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6. Ifthe "acyclic" trigger type has been selected: Enter a relevant trigger name and define the 
time at which the action should be executed. 


Add trigger 


Trigger 


Event: | Single >| 


Trigger name Once per day 


7. If the "cyclic" trigger type has been selected: Enter a relevant trigger name and define the 
start time at which the action should be executed for the first time. Enter a cycle at which 
the action should be repeated. 

Click OK to confirm your entries. 


Note 


An action can be assigned several triggers. The action is always executed when one of the 
triggering events occurs. 


See also 
How to delete a trigger (Page 75) 
How to add a trigger of the type "Tag" (Page 72) 
Triggers (Page 64) 
Creating and Editing Actions (Page 52) 
Actions (Page 18) 
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1.10.7.4 


Introduction 


Procedure 


72 


How to add a trigger of the type "Tag" 


"Tag" type triggers execute an action following the change of a tag value. Any internal or 
external tag stored in WinCC can be used as a trigger tag. 


Actions with tag triggers can be executed at the following times: 


On change of tag: The action is executed each time the tag value changes. Since this 
setting causes a very high system utilization, the updating rate should be set as low as 
possible. 


Query the tag status according to standard cycle (including user cycles): Define a cycle in 
whose intervals the tag value should be queried. The action is only executed when the tag 
value has changed when queried. When the query status is a large value, it is possible that 
the tag value changes but it is not detected by the system. In this case the action will not 
be performed. 


If an action is linked with several tags, the action is executed when one of the tag values 
changes. 


. Open the action. 


Click the button "Info/Trigger" in the toolbar or choose the pop-up menu command "Info". 
The "Properties..." dialog appears. 


3. Select the "Triggers" tab. 


. Select "Trigger" as the tag. 
. Click on the "Add" button. The "Add Trigger" dialog appears. 
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6. Enter the name of the tag to be used as the trigger or click the button beside the "Tag Name" 
field in order to select a tag from the tag selection dialog. 


Add trigger 


Trigger 


Event: Tag 


Tag name Trigger_Var 


Remove 


Trigger name Standard cycle 
Trigger_Var 2s 


7. Double click on the "Standard cycle" field to open the selection dialog for the tag update 
cycle: 


Add trigger 


Trigger 


Event: Tag 


Tag name Trigger_Var 


Update: 


Trigger n 


Tigge¥ 


Select a cycle and click on OK to confirm the selection. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 73 


VBS for Creating Procedures and Actions 


7.10 Creating and Editing Actions 


See also 
How to delete a trigger (Page 75) 
How to add a trigger of the type "Tag" (Page 72) 
How to add a trigger of the type "Timer" (Page 70) 
Triggers (Page 64) 
Creating and Editing Actions (Page 52) 
Actions (Page 18) 


1.10.7.5 How to change a trigger 


Introduction 
A defined trigger can be modified at any time, even during Runtime. 


Procedure 
1. Open the action whose triggers should be modified. 


2. “| Click the button "Info/Trigger" in the toolbar 
or choose the pop-up menu command "Info/Trigger". The "Properties..." dialog appears. 
Alternatively, call in the dialog without executing the action by double clicking on the trigger 
in the navigation window. 


3. Select the "Triggers" tab. 
4. Select the trigger to be modified and click the "Change" button. 


Properties 
— rs | 
=) Timer Add 
s-@ Acyclic Landi 
©) Once per day | Delete 
=} Cyclic 
6 Change 
4-2) Tag 


5. Modify the trigger can confirm the entries with OK. 
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See also 
Triggers (Page 64) 
How to delete a trigger (Page 75) 
How to add a trigger of the type "Tag" (Page 72) 
How to add a trigger of the type "Timer" (Page 70) 
Creating and Editing Actions (Page 52) 
Actions (Page 18) 


1.10.7.6 How to delete a trigger 


Introduction 
Defined triggers can be deleted at any time. Triggers can also be deleted during Runtime. 
If a trigger is deleted in Runtime, it only takes effect after the action is saved. 
Note 
Actions without trigger are not executed in Runtime. None of the actions which used the deleted 
trigger are executed any longer. 
Procedure 


1. Open the Global Script Editor or the Graphics Designer action editor. 
2. Open the action. 


3. © Click the "Info/Trigger" toolbar button or select the "Info/Trigger" menu command. The 
"Properties..." dialog appears. 


4. Select the "Triggers" tab. 
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5. Select the trigger to be deleted and click the "Delete" button. 


Properties 
Thana Toor 
le ti) Timer 
ae (Add __} 
sf omen 
= Cyclic =a 
5 (change _| 
#4) Tag 


6. The trigger is deleted immediately. 


Note 


Triggers can also be deleted directly in the Global Script navigation window using the "Delete" 
command in the context menu. 


See also 
Actions (Page 18) 
How to change a trigger (Page 74) 
How to add a trigger of the type "Tag" (Page 72) 
How to add a trigger of the type "Timer" (Page 70) 
Triggers (Page 64) 
Creating and Editing Actions (Page 52) 


1.10.8 How to Rename an Action 


Introduction 


Actions can be renamed in Global Script. When an action is renamed, the action name and 
file name are changed. 
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The action to be renamed must not be open in the editor window. 


Procedure 
1. Open Global Script. 
2. Select the name of the action to be renamed in the editor's navigation window. 
3. Select the "Rename" command from the context menu. 
4. Enter a new name for the action with the extension *.bac. 
See also 


Protecting an Action with a Password (Page 62) 
Saving Actions (Page 63) 

How to add action-related information (Page 60) 
How to Edit Actions (Page 57) 

Creating a New Action (Page 56) 

Triggers (Page 64) 

Creating and Editing Actions (Page 52) 

Actions (Page 18) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA TT 


VBS for Creating Procedures and Actions 


7.11 How to activate global actions in Runtime 


1.11 How to activate global actions in Runtime 


Introduction 


Scripts defined in Global Script are always executed when the configured trigger occurs. 


Scripts in the graphical Runtime system are executed when the picture is called in and the 
configured event or trigger occurs. 


In order that the picture-independent, Global Script global actions can be executed, the Global 
Script Editor must be registered in the startup list of the Runtime computer. 


Procedure 
1. Select the "Properties" command in the computer's context menu WinCC Explorer. The 
"Computer properties" dialog will open. 
2. Click on the "Startup" tab 
3. Selection option "Global Script Runtime". 
Computer properties 
| General Startup | Parameters | Graphics Runtime | Runtime | 
WinCC runtime start up order 
Ra|Global Script Runtime “ 
[Alarm Logging Runtime 
[-]Tag Logging Runtime 
{_]Report Runtime 
Graphics Runtime 
[| Message Sequence Report /SEQPROT 
Additional Tasks/Applications 
List of WinCC tasks that will be started when the WinCC project is activated 
4. Click OK to confirm your entries. 
WinCC: Scripting (VBS, ANSI-C, VBA) 
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See also 
Creating and Editing Actions (Page 52) 
Creating and Editing Procedures (Page 36) 
VBScript Editors (Page 26) 
Using Visual Basic Script in WinCC (Page 12) 
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1.12 


1.12.1 


Introduction 


Diagnostics 


Diagnostics 


If the scripts are executed and tested in Runtime, the Diagnostics window can be used to 
display an analysis quickly. 


Diagnostics Tools 


80 


WinCC provides a range of tools with which to analyze the behavior of actions in Runtime: 
@ The GSC Runtime and GSC Diagnostics application windows 


e Use of a debugger 


GSC Runtime and GCS Diagnostics 


The GSC Runtime and GSC Diagnostics application window are used by inserting them ina 
process screen. This can be a process screen developed for diagnostics purposes which is 
called in Runtime. 


The application windows are used for different strategies: 


While Runtime is active, GSC Runtime provides information on the dynamic behavior of all 
(Global Script) actions, enables the individual startup as well as log on and off of each individual 
action and offers the access point to the Global Script Editor. 


GSC Diagnostics issues the Trace methods contained in the actions in the chronological 
sequence they are called. This also applies to Trace instructions in procedures which are called 
in actions. The targeted implementation of Trace instructions, e.g. for the output of tag values, 
enables the progress of actions and the procedures called in them to be traced. The Trace 
instructions are entered in the form "HMIlRuntime. Trace(<Ausgabe>)". 


The GSC Diagnostics displays trace output from C and VBS. 


Note 
Runtime errors in VBS are not displayed 


Some script errors are neither output via trace nor displayed via the error dialog. 


Debugger 
You can use the "Microsoft Visual Studio 2008" debugger to test your VB scripts in Runtime. 


The debugger is included in the WinCC Setup. If another Visual Studio version is already 
installed, Microsoft Visual Studio 2010 for example, use the debugger of this version. 
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See also 
Testing with the Debugger (Page 87) 
GSC Runtime (Page 84) 
GSC Diagnostics (Page 81) 

1.12.2 GSC Diagnostics 


1.12.2.1 GSC Diagnostics 


Introduction 


GSC Diagnostics displays the chronological sequence of calls of the trace methods contained 
in the actions in the Diagnostics window. This also applies to Trace instructions in procedures 
which are called in actions. The targeted implementation of Trace instructions, e.g. for the 
output of tag values, enables the progress of actions and the procedures called in them to be 
traced. 


Application 


In order to use GSC Diagnostics, insert a GSC Diagnostics type application window ina 
process screen. The GSC Diagnostics attributes can be used to control the appearance of the 
GSC Diagnostics window. 


In the case of a picture change, the content of the GSC Diagnostics window is deleted. 


Note 


Messages are also displayed in the "GSC Diagnostics" window when the debugger is activated. 


See also 
GSC Diagnostics Toolbar (Page 83) 
GSC Diagnostics Attributes (Page 82) 
Inserting the GSC Diagnostics Window into a Picture (Page 82) 
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1.12.2.2 Inserting the GSC Diagnostics Window into a Picture 


Introduction 


In order to use GSC Diagnostics, insert a GSC Diagnostics process screen. The process 
screen can be an existing picture or a picture which serves customized diagnostics purposes. 
GSC Diagnostics cannot be inserted directly in the process screen as an application but is 
inserted as an application in an application window. In this case, the application window is a 
component part of the process screen. 


Requirements 
Graphics Designer has been started and the process screen is open. 


Procedure 
1. Use the "Smart Objects" object palette to insert the "Application Window" in the picture. 
2. Select the "Global Script" option from the "Window Contents" dialog and confirm the 
selection with "OK". 
3. Select the "GSC Diagnostics" option from the "Templates" dialog. 
4. Confirm the selection with OK in order to insert the Diagnostics window. 
See also 


GSC Diagnostics Toolbar (Page 83) 
GSC Diagnostics Attributes (Page 82) 
GSC Diagnostics (Page 81) 


1.12.2.3 GSC Diagnostics Attributes 


Overview 


GSC Diagnostics has attributes which affect the appearance of the GSC Diagnostics window 
in Runtime. These relate to the geometric attributes, particularly to the following: 


e Display: This attribute defines whether the window should be visible or hidden. The attribute 
can be made dynamic with the name Visible. 


@ Sizeable: This attribute defines whether the size of the window should be changeable in 
Runtime. 


e Movable: This attribute defines whether the window should be moveable or not during 
Runtime. 


¢ Border: This attribute defines whether the without is provided with a border. If the window 
has a border, its height and width can be modified in Runtime. 


e Title: This defines whether the window has a title bar. 
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@ Can be maximized: This attribute defines whether the title bar should contain the button to 
maximize the window. 


e Can be closed: This attribute defines whether the title bar should contain the button to close 
the window. 


e@ Foreground: This attribute defines whether the window should always be in the foreground. 


See also 
GSC Diagnostics Toolbar (Page 83) 
Inserting the GSC Diagnostics Window into a Picture (Page 82) 
GSC Diagnostics (Page 81) 


1.12.2.4 GSC Diagnostics Toolbar 


Overview 
The GSC Diagnostics toolbar enables the output in the diagnostics window to be controlled 
and to save, print and open window content: 
1 234 5 6 
d Co | bad | | 
1: Delete the content of the diagnostics window 
2: Stop the window being updated 
3: Activate the window being updated 
4: Opens a text file in the window 
5: Saves the window contents in a text file 
6: Print the window contents 
See also 


GSC Diagnostics Attributes (Page 82) 
Inserting the GSC Diagnostics Window into a Picture (Page 82) 
GSC Diagnostics (Page 81) 
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1.12.3 


1.12.3.1 


Introduction 


Actions 


Actions Status 
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GSC Runtime 


GSC Runtime 


GSC Runtime is a window which displays the dynamic behavior of all Global Script actions in 
Runtime. In addition, GSC Runtime can also be used during Runtime to influence the execution 
of each individual action and provide access to the Global Script editor. 


C actions and VBS actions are differentiated in the GSC Runtime window: 
e =Symbolizes a C action 

e |*, Symbolizes a VBS action 

The following information is issued: 

e Action name: The name of the action 


e ID: Action ID. They are used internally by the system. GSC Runtime supplies the 
corresponding action name together with the Action ID. The link between ID and action 
name is only valid until Runtime is stopped or, during Runtime, until an action is saved. 


e Status: Provides information on the current status of the action. Refer to the table below 
for the possible statuses. 


e Activation Interval: The time in the form Hour:Minute:Second, which should elapse between 
the action being called. 


e Return Value: The return value of the action 
@ Started On: Date and time the current action was started 
e Next Start: Date and time the action will be started again 


e Error message: Contains the error text in the case of an error 


Possible action status: 

e Action was activated. 

e Action was deactivated 

e Action was stopped. 

e Action in progress 

e Error logging on the action! 


e Error executing the action! 
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Pop-Up Menu 


See also 


1.12.3.2 


Introduction 


Requirements 


7.12 Diagnostics 


The following functions are available for every action in the pop-up menu: 


e Log off: The relevant action will not be executed again when the current execution has 
finished. 


e Log on: The relevant action will be executed again when the next trigger event occurs 
e Start: The relevant action will be executed once. 


e Edit: The relevant action will be opened in the Global Script editor for editing. Runtime will 
remain active. If the edited action is compiled (when necessary) and saved the changes 
will be applied by the Runtime system immediately. 

The option of opening the pop-up menu for every action can be controlled by assigning an 
authorization. 

In order to use GSC Runtime, insert a GSC Runtime type application window in a process 
screen. The GSC Runtime attributes can be used to control the appearance of the GSC 
Runtime window. 


Note 


Updating the GSC Runtime window increases the system load. The system load is dependent 
on how many actions are visible in the window. The system load can be lowered by reducing 
the height of the window so that fewer lines are visible. 


How to insert the GSC Runtime Window into a Picture (Page 85) 
GSC Runtime Attributes (Page 86) 


How to insert the GSC Runtime Window into a Picture 


In order to use GSC Runtime, insert a GSC Runtime process screen. The process screen can 
be an existing picture or a picture which serves customized diagnostics purposes. GSC 
Runtime cannot be inserted directly in the process screen but is inserted as an application in 
an application window. In this case, the application window is a component part of the process 
screen. 


Graphics Designer has been started and the process screen is open. 
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Procedure 


. Use the "Smart Objects" object palette to insert the "Application Window" in the picture. 


. Select the "Global Script" option from the "Window Contents" dialog and confirm the 


selection with "OK". 


3. Select the "GSC Runtime" option from the "Templates" dialog. 


4. Confirm the selection with OK in order to insert the Diagnostics window. 


See also 


GSC Runtime (Page 84) 
GSC Runtime Attributes (Page 86) 


1.12.3.3 GSC Runtime Attributes 


Overview 


GSC Runtime has attributes which affect the appearance of the GSC Runtime window in 
Runtime. These relate to the geometric attributes, particularly to the following: 


See also 


Display: This attribute defines whether the window should be visible or hidden. The attribute 
can be made dynamic with the name Visible. 


Sizeable: This attribute defines whether the size of the window should be changeable in 
Runtime. 


Movable: This attribute defines whether the window should be moveable or not during 
Runtime. 


Border: This attribute defines whether the without is provided with a border. If the window 
has a border, its height and width can be modified in Runtime. 


Title: This defines whether the window has a title bar. 


Can be maximized: This attribute defines whether the title bar should contain the button to 
maximize the window. 


Can be closed: This attribute defines whether the title bar should contain the button to close 
the window. 


Foreground: This attribute defines whether the window should always be in the foreground. 


GSC Runtime (Page 84) 
How to insert the GSC Runtime Window into a Picture (Page 85) 
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1.12.4 Testing with the Debugger 
1.12.4.1 Testing with the Debugger 
Overview 


You can use the "Microsoft Visual Studio 2008" debugger to test your VB scripts in Runtime. 


The debugger is included in the WinCC Setup. If another Visual Studio version is already 
installed, Microsoft Visual Studio 2010 for example, use the debugger of this version. 


Installing the debugger for WinCC 


To use the debugger in WinCC, you must start Setup and specify instance "Visual Studio 2008" 
as the default. 


During the installation of WinCC, the "VS 2008 Shell Redist" folder is created on a drive of the 
PC, for example, as "D:\VS 2008 Shell Redist". 


Procedure 
1. Start the setup with the following file: 
— VS 2008 Shell Redist\Integrated Mode\Vside.enu.exe 


2. Follow the instructions and accept the default settings. 
The following program is installed: 


— Microsoft Visual Studio 2008 Shell (Integrated Mode) - ENU 


3. When you start the debugger the first time, the "Visual Studio Just-In-Time Debugger" 
dialog opens. 
Select the entry "New instance of Visual Studio 2008". 
To specify "Visual Studio 2008" as the default debugger, select the "Set the currently 
selected debugger as the default." setting. 
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Microsoft Visual Studio 2008 Debugger 


q PdIRt (Running) - Microsoft Visual Studio (Administrator) 
File Edit View Project Debug Tools Window Help 


(G-a@|saea|9-¢-|> Pagar wo, 


fo Eas er 


Sub UCC Tag Read cache (Anwender) 
Dim objTag 


Set objTag = HMIRuntime.Tags("S578C::01 vbs Tag UCC_GS VT oF 


HMIRuntime.Trace "01 vbs Tag UCC GS VT as Bool Binary: " & 


HMIRuntime.Trace " Quality Code Ox" & Hex(objTag.Quality) 


HMIRuntime. Trace "02 vbs Tag UCC G5 SVT Signedsbit: " ¢ 
HMIRuntime.Trace = Quality Code Ox" & Hex (objTag.Qualit) 


Set objTag = HMIRuntime.Tags("578C::03 vbs Tag UCC GS VT oF 
HMIRuntime.Trace "03 vbs Taq UCC GS VI jM unsignedsbit: " 
BMTRuntime.Trace " Quality Code Ox" £ HexfohiTadc.Onalit 

» 


je) Autos Ga Call Stack |G Breakpoints |/=] Output 
Ready Ln 10 Col 1 Chi INS 


See also 
Principles of Debugging (Page 90) 
Executing Script Commands (Page 102) 
How to Determine and Modify Tag and Property Values (Page 101) 
How to Set Bookmarks in Scripts (Page 100) 
Deleting Breakpoints (Page 99) 
Setting Breakpoints (Page 98) 
Processing Scripts Step-by-Step (Page 97) 
Selecting a Script for Editing (Page 96) 
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Action and Procedure Names in the Debugger (Page 94) 
Structure of VBScript Files (Page 92) 

How to Activate the Debugger (Page 89) 

Diagnostics (Page 80) 


1.12.4.2 How to Activate the Debugger 


Principle 

There are several ways of activating the debugger: 

e Automatic activation of the debugger when an error occurs in Runtime. 

@ Opening an error box in Runtime via which the debugger can be activated. 

e@ Starting the debugger from the Start menu and opening a running Runtime scripts. 
Procedure 


The following procedure describes the first two points, activating the debugger in WinCC. 


1. In the computer's pop-up menu in WinCC Explorer, select the command "Properties". The 
"Computer Properties" dialog appears. 


2. Select the "Runtime" tab control. 


3. Activate the required debug options. The debug behavior for actions in Global Script and 
Graphics Designer can be set independently of each other: 


Computer properties 
General | Startup | Parameters | Graphics Runtime | Runtime 


VBS Debug Options - Graphics: VBS Debug Options - Global Script: 
¥| Start debugger F a sci 


=I ugger: 
Display error dialog Display error dialog 


4. Select "Start debugger" when the debugger should be started directly following an error in 
the Runtime. 


5. Select "Display Error Dialog", if you do not want to start the Debugger directly but wish to 
display an error dialog with information about the error. The debugger can be started from 
the error box by means of a button. 


6. Click OK to confirm your entries. 


Starting the Debugger and Opening a Running Script 


The debugger can also be started up later and linked to the system currently running. Define 
a connection in the debugger to the respective processes, "pdlirt.exe" for the Graphical Runtime 
System and "gscrt.exe" for the Global Runtime System. The way to open a running script in 
the debugger is described under the topic "Select Script". 
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Exiting the Debuggers 


See also 


1.12.4.3 


Introduction 


Error types 
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It is possible to stop the debugger without exiting the WinCC Runtime. 


How to Set Bookmarks in Scripts (Page 100) 

Executing Script Commands (Page 102) 

How to Determine and Modify Tag and Property Values (Page 101) 
Deleting Breakpoints (Page 99) 

Setting Breakpoints (Page 98) 

Processing Scripts Step-by-Step (Page 97) 

Selecting a Script for Editing (Page 96) 

Action and Procedure Names in the Debugger (Page 94) 
Structure of VBScript Files (Page 92) 

Principles of Debugging (Page 90) 

Testing with the Debugger (Page 87) 

Diagnostics (Page 80) 


Principles of Debugging 


You can use the "Microsoft Visual Studio 2008" debugger to test your VB scripts in Runtime. 


The debugger is included in the WinCC Setup. If another Visual Studio version is already 
installed, Microsoft Visual Studio 2010 for example, use the debugger of this version. 


The debugger can be used to: 

e View the script source code to be debugged 

@ Step-by-step processing of the scripts to be checked 
e Display and modify tag and property values 


e View and monitor the script progress 


Note 


Please note that the code displayed in the debugger is write-protected. The code cannot 
be changed directly in the debugger but only test the necessary changes. 


A distinction is made between the following types of error by the debug: 
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Syntax errors 


Syntax errors occur, for example, when a key word is written incorrectly or a parenthesis is 
not closed. When a syntax check from WinCC is used, syntax errors can be excluded before 
testing the scripts in Runtime. In principle, only syntactically correct scripts can be saved in 
Graphics Designer. The WinCC syntax check also checks: 


e Whether the procedure names are unique in Global Script 
@ Whether an action module in Global Script contains only one procedure 
e Whether the action part in Graphics Designer contains only one procedure 


As a result of the syntax check in WinCC, the script is parsed without being executed. The 
script is parsed again directly before executing in Runtime. All the script parts are parsed, even 
those which are executed after a certain action has been executed at a later time. 


If the script contains syntax errors, the script is not executed in Runtime. 


Runtime error 


A Runtime error occurs when an attempt is made to execute an invalid/erroneous action, e.g. 
because a tag has not been defined. In order to intercept Runtime errors, use the "On Error 
Resume Next" command in the VBScript. The command causes the subsequent command to 
be executed following a Runtime error. The error code can subsequently be checked using 
the Err object. In order to deactivate the processing of Runtime errors in the script, use the 
"On Error Goto 0" command. 


Logical errors 


The debugger is particularly helpful in clearing up logical errors. A logical error occurs when 
an unexpected result is received because, for example, a condition was incorrectly checked. 
To clear logical errors, go through the scripts step-by-step in order to detect the part which 
does not function properly. 


Basic Procedure 


When an error has occurred and the debugger is open, the script appears in a window, write- 
protected. It is possible to navigate through the script document, set breakpoints, execute the 
script again in Runtime and to process the script step-by-step. 


The most important steps for successful debugging of the scripts are described under 
"Processing Scripts Step-by-Step". 


The source codes of the scripts cannot be edited directly in the scripts. When an error has 
been detected, the error can be corrected in the original script in WinCC, e.g. load the picture 
again and update it in the debugger. 


Note 


Tips and tricks for debugging, frequently occurring error codes and other information is 
available in the Microsoft Script Debugger online help. 
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Change Picture During Debug 


See also 


If a picture change is executed during debugging, the script document of the "old" picture 
remains open but is no longer valid. If necessary, invalid errors are displayed because the 
objects called following the picture change are no longer available. 
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1.12.4.4 Structure of VBScript Files 


Principle 


92 


In order not to hinder the simultaneous processing of cyclic and event-driven scripts in the 
graphical Runtime system, the event-driven actions and cyclic/tag-driven actions are strictly 
separated during processing. In this way, a cyclic action, for example, cannot hinder the 
execution of an action initiated by clicking a button. 


To ensure this, the event-driven actions and the cyclic/tag-driven actions are stored in separate 
script files when saving a picture. If a global picture section has been defined in actions in 
Graphics Designer, this is copied into both scripts. In the same way, modules which are used 
in an action are also copied in both script files. 


If a tag from a module should be used, the corresponding module must be called in. Otherwise, 
the module is not copied in the script file and an error is generated. 


Note 


Since the two script files are handled separately, they have no common data area. Therefore, 
there is no synchronization of global tags between the two script files. If synchronization is 
required, implement this using the DataSet object or internal WinCC tags. 
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Structure of the Script Files 


When scripts are debugged with a debugger, the script files always open the different Runtime 
systems. 


In the case of the graphical Runtime system, this means that you receive two script files per 
picture: 


e <Bildname>.pdl_events: Contains the event-driven actions. 
e® <Bildname>.pdl_triggers: Contains the cyclic and tag-controlled actions. 


The following section describes how the script files are structured: 


Graphical Runtime system 


Script file contents Script file contents 
<picture name>.pdl_events 


Standard modules (if used) 


Project modules (if used) 
Event-controlled actions 


Cyclical or tag-triggered actions 


Global Script Runtime 


Global Script Runtime environment 


Required standard module n 


Required project module 1 
Required project module n 
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Note 


Please note that the actions and procedures of the graphic Runtime system are not displayed 
with the action name in the script file under which it was saved in WinCC. The name 
conventions for actions and procedures in the script files sate described in "Action and 
Procedure Names in the Debugger". 


See also 
How to Activate the Debugger (Page 89) 
Executing Script Commands (Page 102) 
How to Determine and Modify Tag and Property Values (Page 101) 
How to Set Bookmarks in Scripts (Page 100) 
Deleting Breakpoints (Page 99) 
Setting Breakpoints (Page 98) 
Processing Scripts Step-by-Step (Page 97) 
Selecting a Script for Editing (Page 96) 
Action and Procedure Names in the Debugger (Page 94) 
Principles of Debugging (Page 90) 
Testing with the Debugger (Page 87) 
Diagnostics (Page 80) 


1.12.4.5 Action and Procedure Names in the Debugger 


Action and Procedure Names in the Debugger 


The names of procedures and actions in debugger script files differ from the names under 
which they were saved by the scripts in WinCC. 


The action and procedure names in the script files are compiled according to the following 


rules: 

Action type Name of the script file 

Cyclic or tag-driven actions on a property ObjectName_PropertyName_Trigger 
Mouse events ObjektName_OnClick 


ObjektName_OnLButtonDown 
ObjektName_OnLButtonUp 


ObjektName_OnRButtonDown 


ObjektName_OnRButtonUp 
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Action type Name of the script file 
Keyboard events ObjektName_OnKeyDown 


ObjektName_OnKeyUp 
Object events ObjektName_OnObjectChanged 


ObjektName_OnSetFocus 


Events on properties ObjektName_PropertyName_OnPropertyChanged 
ObjektName_PropertyName_OnPropertyState- 
Changed 

Picture events Document_OnOpen 


Document_OnClosed 


Permitted length of action names 


The names of the actions in the script files are limited to 255 characters. Each special character 
used in an object name is converted to five characters. The special characters are represented 
by a four-place hexadecimal code behind the preceding X. If, for example, an action is 
configured on a button with the name "PushHere" per mouse click, the script in the script file 
appears as "PushHere_OnClick". 


If the object name compiled is too long, an error message is issued during the syntax check 
in WinCC. As a result of this restriction, graphic object names cannot be selected with any 
length during configuration. 


Note 


If you wish to determine the name of an object in Runtime, press <CTRL+ALT+SHIFT> and 
position the mouse over the corresponding object. The picture name and object name then 
appears in a tooltip. 


See also 
Executing Script Commands (Page 102) 
How to Determine and Modify Tag and Property Values (Page 101) 
How to Set Bookmarks in Scripts (Page 100) 
Deleting Breakpoints (Page 99) 
Setting Breakpoints (Page 98) 
Processing Scripts Step-by-Step (Page 97) 
Selecting a Script for Editing (Page 96) 
Structure of VBScript Files (Page 92) 
Principles of Debugging (Page 90) 
How to Activate the Debugger (Page 89) 
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1.12.4.6 Selecting a Script for Editing 


Introduction 


Requirement 


Procedure 


See also 
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If the Microsoft Script Debugger is called in Windows instead of automatic activation using 
WinCC, scripts which are currently running can be called in for editing in Runtime. 


Runtime is activated, the picture to be debugged is active. 


1. Start Microsoft Visual Studio 2008. 
2. Create a new script file: 
— File > New > File... > Select script template "Windows Script Host". 


3. Start debugging with "Debug > Attach to Process". 
Select, for example, gscrt.exe or pdirt.exe. 
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1.12.4.7 Processing Scripts Step-by-Step 


Introduction 


The Microsoft Script Debugger can be used to process the scripts step-by-step in order, for 
example, to locate logical errors systematically. The effect of each individual script line can be 
tested in Runtime. 


The Procedure in Principle 
1. Activate the document to be debugged in Runtime. 


2. Start the debugger manually from the Start menu and open the required script file or activate 
the debugger in WinCC. When activated in WinCC, the debugger automatically opens when 
an attempt is made to execute an erroneous script. 


3. Seta breakpoint in the script file. Breakpoints are normally set in front of code lines in which 
errors are suspected. 


4. Switch to WinCC Runtime and trigger an action which causes the script to run. 
The Debugger stops at the first breakpoint and marks the current line. 


5. In order to go through the script document step-by-step, select one of the following menu 
commands: 
"Debug" > "Step Into": Skip to the next code line. If the script calls a procedure in this line, 
it skips to the procedure using the "Step Into" command. The procedure called can then be 
processed step-by-step. 


"Debug" > "Step Over": Skips the procedure called. The procedure is called but the 
debugger does not stop at the individual lines of the procedure. Instead, it moves to the 
next line of the current script after the procedure has been executed. 


6. To interrupt the step-by-step processing of a procedure, select the "Debug" > "Step Out" 
menu commands. The debugger then skips to the next action. 


7. Proceed step-by-step to the end of the document or select the "Debug" > "Run" menu items 
to start the script again in Runtime. 


See also 
Principles of Debugging (Page 90) 
Executing Script Commands (Page 102) 
How to Determine and Modify Tag and Property Values (Page 101) 
How to Set Bookmarks in Scripts (Page 100) 
Deleting Breakpoints (Page 99) 
Setting Breakpoints (Page 98) 
Selecting a Script for Editing (Page 96) 
Action and Procedure Names in the Debugger (Page 94) 
Structure of VBScript Files (Page 92) 
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1.12.4.8 Setting Breakpoints 


Introduction 


Breakpoints can be set in a script to stop at specific points when processing it and to start the 
debugger. Set a breakpoint in front of a line, for example, which you suspect contains a script 
error. 


It is possible to: 
e Set breakpoints at specific lines to locate logical errors in the script step-by-step. 


@ Seta breakpoint and call the debugger before the next line in the script is processed. These 
procedure is used, for example, for events such as "Change picture". 


When a script file is updated in the debugger, all the breakpoints are lost. 


If a breakpoint is set in one of the script files "<Bildname>.pdl_trigger" or 
"<Bildname>.pdl_event", all the trigger-driven or all event-driven procedures are stopped, 
respectively, in Runtime. 


Requirements 


Runtime is activated, the picture to be debugged is active. 


Procedure 


Setting a breakpoint 


1. Start the debugger and select the script. If automatic activation of the debuggers in WinCC 
has been selected, the debugger is called in as soon as an erroneous script is executed. 


2. Position the cursor on the action in which a breakpoint should be set. 


3. Open the "Debug" menu and select the "Toggle Breakpoint" item or the icon “4 from the 
toolbar. 
The next executable line will be marked by a red dot. 


4. Switch to WinCC Runtime and execute the action you wish to debug. 
The Debugger stops at the first breakpoint it finds in the script. The current line is displayed 
on a yellow background. The script can then be processed step-by-step. 


See also 
Deleting Breakpoints (Page 99) 
Executing Script Commands (Page 102) 
How to Determine and Modify Tag and Property Values (Page 101) 
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1.12.4.9 


Introduction 


Procedure 


See also 


1.12 Diagnostics 


How to Set Bookmarks in Scripts (Page 100) 

Setting Breakpoints (Page 98) 

Selecting a Script for Editing (Page 96) 

Action and Procedure Names in the Debugger (Page 94) 
Structure of VBScript Files (Page 92) 

Principles of Debugging (Page 90) 

How to Activate the Debugger (Page 89) 

Testing with the Debugger (Page 87) 

Diagnostics (Page 80) 


Deleting Breakpoints 


When an error has been cleared properly, the breakpoints in a script can be cleared individually 
or all together. 


1. Position the cursor in the line whose breakpoint is to be deleted. 


2. Open the "Debug" menu and select the "Toggle Breakpoint" item or the icon 4 from the 
toolbar. 
The next line will be displayed without a mark. 


3. To delete all the breakpoints in a script, open the "Debug" menu and select the "Clear all 
Breakpoints" entry or the icon ® from the toolbar. 


Executing Script Commands (Page 102) 

How to Determine and Modify Tag and Property Values (Page 101) 
How to Set Bookmarks in Scripts (Page 100) 

Setting Breakpoints (Page 98) 

Selecting a Script for Editing (Page 96) 

Action and Procedure Names in the Debugger (Page 94) 
Structure of VBScript Files (Page 92) 

Principles of Debugging (Page 90) 

How to Activate the Debugger (Page 89) 

Testing with the Debugger (Page 87) 

Diagnostics (Page 80) 
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1.12.4.10 How to Set Bookmarks in Scripts 


Introduction 


See also 


100 


During the debug routine, bookmarks can be set on code lines so that they can be found easier 
again one line later. 

Setting or deleting bookmarks 

Position the mouse pointer in the row where you wish to set a bookmark, and click <CTRL+F9> 
to set a bookmark or <CTRL+SHIFT+F9> to delete one. 


Skipping to the next bookmark 
Press <F9> to go to the next bookmark in the script. 


Skipping to the previous bookmark 
Press <SHIFT+F9> to go to the previous bookmark in the script. 


Executing Script Commands (Page 102) 

How to Determine and Modify Tag and Property Values (Page 101) 
Deleting Breakpoints (Page 99) 

Setting Breakpoints (Page 98) 

Selecting a Script for Editing (Page 96) 

Action and Procedure Names in the Debugger (Page 94) 
Structure of VBScript Files (Page 92) 

Principles of Debugging (Page 90) 

How to Activate the Debugger (Page 89) 

Testing with the Debugger (Page 87) 

Diagnostics (Page 80) 
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1.12.4.11 How to Determine and Modify Tag and Property Values 


Introduction 


While a script is running in Runtime, the "Command Window" of the debugger can be used, 
for example, to compile and modify values of tags or properties in the script currently running. 
It is possible, for example, to reset a process value for a script to zero without having to stop 
the process. 


Note 


If you wish to determine the name of a WinCC object in Runtime, click <CTRL+ALT+SHIFT> 
and position the mouse over the corresponding object. The picture name and object name 
then appears in a tooltip. 


Requirements 


The script runs in Runtime and the debugger is opened. 


Procedure 
1. Set at least one breakpoint in the current script. 
2. Switch to WinCC Runtime and trigger an action which causes the script to be executed. 
The Debugger stops at the first breakpoint. 
3. Open the "View" menu and activate the "Command Window" entry. 
The "Command Window" opens. 
4. In order to determine the value of a tag or property, enter a '"?" followed by a Space and 
the name of the tag or property whose value is to be determined, e.g. "?myTag". 
Press <RETURN> to execute the command. 
5. In order to modify the value of a tag/property, assign a value in the VBS syntax. 
See also 


Principles of Debugging (Page 90) 

Executing Script Commands (Page 102) 

How to Set Bookmarks in Scripts (Page 100) 

Deleting Breakpoints (Page 99) 

Setting Breakpoints (Page 98) 

Selecting a Script for Editing (Page 96) 

Action and Procedure Names in the Debugger (Page 94) 
Structure of VBScript Files (Page 92) 

How to Activate the Debugger (Page 89) 
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Testing with the Debugger (Page 87) 
Diagnostics (Page 80) 


1.12.4.12 Executing Script Commands 


Introduction 


Requirements 


Procedure 


See also 


102 


While a script is running in Runtime, the "Command Window" of the debugger can be used to 
execute script commands directly and thus manipulate the running of the current script. The 
script commands can be executed directly for test purposes without creating the command in 
a script and activating it. It is possible, for example: 


e To retrieve methods 
e To retrieve procedures 
@ To manipulate object properties 


"Command Window" can basically be used to execute all commands which can also be 
executed from a VBScript. 


The script runs in Runtime and the debugger is opened. 


1. Set at least one breakpoint in the current script. 


2. Switch to WinCC Runtime and trigger an action which causes the script to be executed. 
The Debugger stops at the first breakpoint. 


3. Open the "View" menu and activate the "Command Window" entry. 
The "Command Window" opens. 


4. Enter the required command and press "ENTER". 


Note 


If a faulty command is entered in the Command window, no error message is issued in Runtime. 
The message "<Script Error> appears in the Command window instead. 


How to Determine and Modify Tag and Property Values (Page 101) 
How to Set Bookmarks in Scripts (Page 100) 

Deleting Breakpoints (Page 99) 

Setting Breakpoints (Page 98) 

Selecting a Script for Editing (Page 96) 
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Action and Procedure Names in the Debugger (Page 94) 
Structure of VBScript Files (Page 92) 

Principles of Debugging (Page 90) 

How to Activate the Debugger (Page 89) 

Testing with the Debugger (Page 87) 

Diagnostics (Page 80) 
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1.13 Printing VBScripts 


Principle 


The actions and procedures configured in both Global Script and in Graphics Designer can be 
documented in WinCC. 


The documentation options are distinguished between: 


e Print Feedback Doc: In Graphics Designer, all the configured actions are printed with the 
feedback of the current picture. The Feed Back contains the C-actions and VBS actions, 
located beside each other, differentiated by the source text (C or VBScript). 


e Print current script: The Feed Back in Global Script always contains the currently open 
procedure or action. 


WinCC provided predefined print layouts for the layout of the Feed Back. Customized print 
layouts can also be developed and linked to the Print Job tab control with "Project 
Documentation - Setup". 


Procedure 
1. Open Global Script or Graphics Designer according to the scripts to be documented. 
2. Configure the print job, if necessary, using the "Project Documentation - Setup" command. 
3. Use the "View Project Documentation" command to preview the data to be printed. 
4. Select the menu commands "File" > "Print Project Documentation" to print the data. 
See also 


Creating and Editing Actions (Page 52) 
Creating and Editing Procedures (Page 36) 
VBScript Editors (Page 26) 

Using Visual Basic Script in WinCC (Page 12) 
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1.14 VBS Reference 


1.14.1 VBS Reference 


VBS object model in WinCC 


The WinCC object model of the graphic Runtime system enables access to graphic objects 
and tags in Runtime. 


When you click on an object name, you are shown a detailed description. 
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ActiveProject 


|_| Object and List 
Object 


[| Property provided by an object 


The VBS object model in a faceplate type 


The VBS object model is not valid for WinCC in a Faceplate type. It is replaced by a completely 
new model. 
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The VBS object model of the Faceplate type provides you with access to the graphic objects 
and Faceplate tags of the Faceplate type in Runtime. 


Objects 
Objects and lists are provided for access to all the objects in the graphic Runtime systems: 
Graphic objects, pictures, layers and tags. 

Properties 
The properties of the individual objects can be used to modify specific graphic objects and 
tags in Runtime , e.g. activating an operating element per mouse click or triggering a color 
change by modifying a tag value. 

Methods 
Methods, which are applied to individual objects, can be used to read tag values for further 
processing or display diagnostics messages in Runtime. 

See also 
Object types of the Screenltem object (Page 143) 
Methods (Page 710) 
Properties (Page 301) 
Objects and Lists (Page 107) 

1.14.2 Objects and Lists 

1.14.2.1 Objects and Lists 

Overview 


The objects and lists provided in WinCC object models enables access to graphic objects and 
tags in Runtime. 


Navigation in Object Models 


Access is made to objects in the VBS object model in hierarchical sequence. If, for example, 
a picture element is accessed within a picture, access is made to the picture element in the 
picture via its parent object (the surrounding picture). 
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Example: 


Picture window in the basic picture "GB" 


Circle "Circle1" 
in the picture "Bild2" 


Dim MyCircle 
Set MyCircle = SecreenItem("Circlei") 


MsgBox MyCircle.Parent.Parent.Parent.Parent.Parent.name ' 


Only the basic picture name is issued in this example. 


Access to Graphic Objects 


In WinCC, access is made to pictures, layers and graphic objects in Runtime using the 
superordinate "HMIRuntime" object. Access to objects and layers is always made via the 
picture (screen) in which they are contained. 


Access to Tags 


In WinCC, tags are accessed directly in Runtime using the superordinate "HMIRuntime" object. 
Tag values can be read out or set anew. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
108 System Manual, 02/2016, A5E37536061-AA 


VBS for Creating Procedures and Actions 


Lists 


Available Objects 


See also 


Alarm 
Alarms 
AlarmLogs 
Dataltem 
DataLogs 
DataSet 

HM Runtime 
Item 

Layer 
Layers 
Logging 
ProcessValues 
ProcessValue 
Project 
Screenltem 
Screenltems 
Screen 
Screens 

Tag 

Tags 
TagSet 


Screenltems Object (List) (Page 129) 
TagSet Object (List) (Page 141) 
Tags Object (List) (Page 140) 

Tag Object (Page 137) 

Screens Object (List) (Page 134) 
Screen Object (Page 131) 
Screenltem Object (Page 125) 
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Lists of WinCC object models behave in the same way as standard collections of VBS. 
Exception: The "Tags" list has no Enum function. 
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Layers Object (Listing) (Page 121) 
Layer Object (Page 120) 

Item Object (Page 119) 

HM IRuntime Object (Page 118) 


1.14.2.2 Alarm object 


Description 
HMIRuntime 
The alarm object is used to access the Alarms object list. 
Note 
The properties of the alarm object are not automatically updated when the values of the 
properties change. 
See also 


Alarms object (list) (Page 110) 
1.14.2.3 Alarms object (list) 


Description 


HMIRuntime 


ProcessValues 


ProcessValue 


Use the alarm object to trigger existing messages. 
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Usage 
Using the "Alarms" list you can: 
e Access a message in the list (Item method) 
@ Create a new alarm object (Create method) 
e Read the alarm ID of the message (AlarmID attribute) 
e Set the status of a message (State property) 
e Set the time stamp of the message (Timestamp property) 
e Generate an instance of the alarm object (Instance property) 
e Read the name of the computer on which the message came (ComputerName property) 
@ Read the name of the user who triggered the message (UserName property) 
@ Set the names of the process value blocks (ProcessValues property) 
e Set the comment of the message (Comment property) 
@ Set the server prefix of the message (Context property) 
Example 
In the following example, the message with the alarm number "1" configured in the Alarm 
Logging Editor will be triggered: 
"VBS360 
Dim MyAlarm 
Set MyAlarm = HMIRuntime.Alarms (1) 
yAlarm.State = 5 'hmiAlarmStateCome + hmiAlarmStateComment 
yAlarm.Comment = "MyComment" 
yAlarm.UserName = "Hans-Peter" 
yAlarm.ProcessValues(1) = "Process Value 1" 
yAlarm.ProcessValues (4) = "Process Value 4" 
yAlarm.Create "MyApplication" 
See also 


TimeStamp Property (Page 622) 
ComputerName property (Page 391) 
Context property (Page 391) 

State property (Page 587) 

AlarmID property (Page 308) 
Instance property (Page 454) 
Comment property (Page 390) 
UserName property (Page 676) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 111 


VBS for Creating Procedures and Actions 
7.14 VBS Reference 


ProcessValue property (Page 545) 
Alarm object (Page 110) 
ProcessValues Object (List) (Page 124) 
Create method (Page 716) 

Item Method (Page 770) 


1.14.2.4 AlarmLogs Object 


Description 


Logging 


Alarmlogs 


Datalogs 


Using the object, swapped archive segments of Alarm Logging may be reconnected to 
Runtime, or previously swapped archive segments of Alarm Logging may be deleted again. 
Therein 


e Archive segments to be swapped are copied to the common archiving directory of the 
WinCC project, or 


@ previously swapped archive segments are deleted in the common archiving directory. 


Using parameters you may control from where archive segments are to be swapped. You may 
also specify the time period over which archive segments are to be swapped or deleted. Archive 
segments are copied to the common archiving directory of the project. 


If an error occurred during the operation with archiving segments, the method used returns an 
error message. Additional information may be found under the subject heading "Error 
Messages from Database Area". 


Usage 


Previously swapped archive segments of Alarm Logging may be connected with Runtime 
("Restore" method). 


Previously swapped archive segments of Alarm Logging may be deleted from the Runtime 
project ("Remove" method). 


Example: 


In the following example, archive segments from Alarm Logging are swapped and the return 
value is output as Trace. 


'VBS187 
HMIRuntime.Trace "Ret: " & HMIRuntime.Logging.AlarmLogs.Restore("D: 
\Folder","2004-09-14","2004-09-20",-1) & vbNewLine 
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See also 
Error Messages from Database Area (Page 820) 
Restore Method (Page 794) 
Remove Method (Page 789) 
DataLogs Object (Page 114) 
Logging Object (Page 122) 
1.14.2.5 Dataltem Object 
Description 
HMIRuntime 
DataSet 
Dataltem 
The Dataltem object is used to access the contents of the DataSet list. Values or object 
references are stored in the list as Dataltem. 
Access uses the name under which the value was added to the list. Single access using an 
index is not recommended since the index changes during adding or deleting of values. The 
index may be used to output the complete contents of the list. The output is in alphabetical 
order. 
Note 
For object references it must be ascertained that objects are multiread-enabled. 
Example: 
The example shows how the value of 'Motor1' is output as Trace. 
'VBS163 
HMIRuntime.Trace "motorl: " & HMIRuntime.DataSet ("motorl1") .Value & vbNewLine 
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The following example enumerates all Dataltem objects of the DataSet list. Name and value 
are output as Trace. 


"VBS164 
Dim data 
For Each data In HMIRuntime.DataSet 
HMIRuntime.Trace data.Name & ": " & data.Value & vbNewLine 
Next 
Note 
For objects, value may possibly not be output directly 
See also 


Screen Object (Page 131) 

HM IRuntime Object (Page 118) 
DataSet Object (List) (Page 116) 
Value Property (Page 680) 
Name Property (Page 509) 


1.14.2.6 DataLogs Object 


Description 


Alarmlogs 


Logging 


Datalogs 


Using the object, swapped archive segments of Tag Logging may be reconnected to Runtime, 
or previously swapped archive segments of Tag Logging may be deleted again. Therein 


e Archive segments to be swapped are copied to the common archiving directory of the 
WinCC project, or 


@ previously swapped archive segments are deleted in the common archiving directory. 


Using parameters you may control from where archive segments are to be swapped. You may 
also specify the time period over which archive segments are to be swapped or deleted. In 
addition, you may set the archive type ("Tag Logging Fast", "Tag Logging Slow", "Tag Logging 
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Fast and Tag Logging Slow"). Archive segments are copied to the common archiving directory 
of the project. 


If an error occurred during the operation with archiving segments, the method used returns an 
error message. Additional information may be found under the subject heading "Error 
Messages from Database Area". 


Usage 
Previously swapped archive segments of Tag Logging may be connected with Runtime 
("Restore" method). 
Previously swapped archive segments of Tag Logging may be deleted from the Runtime 
project ("Remove" method). 

Example: 
In the following example, fast archive segments from Tag Logging are swapped and the return 
value is output as Trace. 

'VBS188 

HMIRuntime.Trace "Ret: " & HMIRuntime.Logging.DataLogs.Restore("D: 


\Folder", "2004-09-14", "2004-09-20",-1,1) & vbNewLine 


See also 


Error Messages from Database Area (Page 820) 
Restore Method (Page 794) 

Remove Method (Page 789) 

AlarmLogs Object (Page 112) 

Logging Object (Page 122) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 115 


VBS for Creating Procedures and Actions 
7.14 VBS Reference 


1.14.2.7 DataSet Object (List) 


Description 
HM Runtime 
DataSet 
Dataltem 
Using the DataSet object, data may be exchanged across several actions. 
A DataSet object is global and defined by the Screen object. Any VBS action may access the 
data. 
The DataSet object at the Screen object must be addressed according to picture hierarchy 
and shall persist as long as the picture is displayed. The global object persists over the entire 
Runtime time period. 
Access uses the Dataltem object. 
Note 
Objects of type Screen, Screens, Screenltem, Screenltems, Tag and TagSet cannot be 
included in the DataSet list. 
The DataSet object does not support any classes. 
Usage 


Using the "DataSet" list, you may: 

¢ Output or process (enumerate) all objects in the list. 

e Output the number of elements contained ("Count" property). 
e To process a specific object in the list ("Item" method). 

e Add an object to the list ("Add" method). 

e Remove a specific object from the list ("Remove" method). 

e Remove all objects from the list "RemoveAll" method). 


Access to list elements uses: 


HMTRuntime.DataSet ("Itemname") 
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For a picture-specific list, access uses: 


HMIRuntime.Screens ("Screenname") .DataSet ("Itemname") 


In a picture, you may access the DataSet object of the picture by using: 


DataSet ("Itemname") 


If upon access the stated name does not exist in the list, VT_Empty is returned and an 
Exception is triggered. 


Example: 
The example shows how to add a value to the list, how to read it and remove it. It make sense 


to perform this in several different actions. 


"'VBS162 


HMTRuntime.DataSet.Add "motorl1", 23 
HMIRuntime.Trace "motorl: " & HMIRuntime.DataSet ("motorl1") .Value & vbNewLine 


HMIRuntime.DataSet.Remove ("motor1") 


See also 
Dataltem Object (Page 113) 


RemoveAll Method (Page 792) 
Remove Method (Page 789) 
Item Method (Page 770) 
Count Property (Page 393) 
Add Method (Page 713) 
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1.14.2.8 HM Runtime Object 


Description 


HM IRuntime 
ActiveProject 


Screens 
Screen 


Logging 


Alarms 
Alarm 


The HMIRuntime object represents the graphic Runtime environment. 


Usage 
The "HMIRuntime" object can be used for the following, for example: 
e Read or set the current Runtime language ("Language" property). 
e Read or set the name of the current base picture ("BaseScreenName" property). 
e Read the path of the active Runtime project ("ActiveProject" property). 
e Access tags ("Tags" property). 
e Access tags of a list ("DataSet" property). 
e Exit Runtime ("Stop" method). 


e Display messages in a diagnostics window ("Trace" method). 


WinCC: Scripting (VBS, ANSI-C, VBA) 
118 System Manual, 02/2016, ASE37536061-AA 


VBS for Creating Procedures and Actions 
7.14 VBS Reference 


Example: 


The following command terminates WinCC Runtime: 


'VBS3 
HMTRuntime.Stop 


See also 
Screens Object (List) (Page 134) 
TagSet Object (List) (Page 141) 
Tags Object (List) (Page 140) 
Logging Object (Page 122) 
DataSet Object (List) (Page 116) 
Visible Property (Page 696) 
Trace Method (Page 811) 
Tags Property (Page 597) 
Stop Method (Page 810) 
AlignmentLeft Property (Page 309) 
Logging Property (Page 484) 
Language Property (Page 458) 
DataSet Property (Page 398) 
CurrentContext Property (Page 394) 
BaseScreenName Property (Page 342) 
ActiveProject Property (Page 303) 
ActiveScreen Property (Page 304) 
MenuToolBarConfig Property (Page 495) 
Alarms object (list) (Page 110) 


1.14.2.9 Item Object 


Description 


The "Item" object provides a reference to the current object. 
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Usage 
The "Item" object is used, for example, to address the properties of the object currently selected 
in Graphics Designer. 
Example: 
In the following example, a rectangle has been created. When the object has been selected, 
all the properties of the current object can be set a background color red: 
'VBS195 


Item.BackColor = RGB(255,0,0) 


See also 
Objects and Lists (Page 107) 


1.14.2.10 Layer Object 


Description 

The layer object returns the result of access to the layers list. 
Parent Object 

Picture, in which the picture layer is. 
Usage 


Depending on certain events, the Layer object can be used to obtain access to the properties 
of a complete layer in order, for example, to hide or unhide a layer with operating elements 
according to the operator authorization. 
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The "Layer" object can be used to: 
e To activate or deactivate the visualization of a layer ("Visible" property). 


e To read out the name of a layer ("Name" property). 


Note 


The layer property specifies the layer in which the object is located. The layer "0" is output 
as "LayerO". 


When accessed, the layers are counted up from 1 in VBS. Therefore, the layer "1" must be 
addressed with "layers(2)". 


Example: 
In the following example, Layer 1 is set invisible: 


'VBS4 
Layers (2).Visible = vbFalse 


See also 
Layer Object (Page 120) 
Visible Property (Page 696) 
Parent Property (Page 529) 
Name Property (Page 509) 


1.14.2.11 Layers Object (Listing) 


Description 
Screens 
Screen 
The Layers list enables access to all 32 layers of the graphical Runtime system. 
Parent Object 


Picture, in which the picture layer is. 
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Usage 


See also 


1.14.2.12 


Description 


Usage 


122 


The "Layers" list can be used to: 

e Process all layers in the list ("_NewEnum" property). 

e Count all layers contained in the list ("Count" property). 
e Process a layer from the list ("Item" method). 


The properties represent default properties and methods of a list and are not described in detail 
in the WinCC documentation. 


Parent Property (Page 529) 
Item Method (Page 770) 
Count Property (Page 393) 
Layer Object (Page 120) 


Logging Object 


HM Runtime 
Logging 


Alarmlogs 


Datalogs 


Using the object, swapped archive segments may be reconnected to Runtime, or previously 
swapped archive segments may be deleted again. Therein 


e Archive segments to be swapped are copied to the common archiving directory of the 
WinCC project, or 


@ previously swapped archive segments are deleted in the common archiving directory. 


Using parameters you may control from where archive segments are to be swapped. You may 
also specify the time period over which archive segments are to be swapped or deleted. Archive 
segments are copied to the common archiving directory of the project. 


If an error occurred during the operation with archiving segments, the method used returns an 
error message. Additional information may be found under the subject heading "Error 
Messages from Database Area". 


Previously swapped archive segments of Alarm Logging and Tag Logging may be connected 
with Runtime ("Restore" method). 
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Previously swapped archive segments of Alarm Logging and Tag Logging may be deleted 
from the Runtime project ("Remove" method). 


Example: 
In the following example, archive segments from Alarm Logging and Tag Logging are swapped 
and the return value is output as Trace. 
'VBS189 
HMIRuntime.Trace "Ret: " & HMIRuntime.Logging.Restore("D: 


\Folder", "2004-09-14", "2004-09-20",-1) & vbNewLine 


See also 
Error Messages from Database Area (Page 820) 
DataLogs Object (Page 114) 
AlarmLogs Object (Page 112) 
Restore Method (Page 794) 
Remove Method (Page 789) 
DataLogs Property (Page 398) 
AlarmLogs Property (Page 308) 


1.14.2.13 ProcessValue Object 


Description 
ProcessValues 
The ProcessValue object is used to access the ProcessValues object list. 
Note 
Only the 10 predefined ProcessValues are supported. 
See also 


ProcessValues Object (List) (Page 124) 
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1.14.2.14 


Description 


Usage 


See also 


1.14.2.15 


Description 
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ProcessValues Object (List) 


Alarms ProcessValues 


Alarm ProcessValue 


Using the "ProcessValues" list, you can: 

e Edit a ProcessValue from the list ("Item" method) 

e Display or edit all the objects in the list (.NewEnum attribute) 

e Count all ProcessValues contained in the list (Count property) 

e Read or set the values of the ProcessValue object (Value property) 


The properties represent default properties and methods of a list and are not described in detail 
in the WinCC documentation. 


Alarms object (list) (Page 110) 
ProcessValue Object (Page 123) 
Count Property (Page 393) 
Value Property (Page 680) 

Item Method (Page 770) 


Project Object 


HMIRuntime 


ActiveProject 


Using the object, information may be requested from the current Runtime project. 


The project object is returned as the result of ActiveProject. 
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Usage 
Using the "Project" object, you may: 
e Read the path of the current Runtime project ("Path" property). 
e Read the name of the current Runtime project, without path or file extension ("Name" 
property). 
Example: 
The following example returns name and path of the current Runtime project as Trace: 
'VBS159 
HMIRuntime.Trace "Name: " & HMIRuntime.ActiveProject.Name & vbNewLin 
HMTIRuntime.Trace "Path: " & HMIRuntime.ActiveProject.Path & vbNewLine 
See also 


ActiveProject Property (Page 303) 
Name Property (Page 509) 
Path Property (Page 531) 


1.14.2.16 Screenltem Object 


Description 


Screen 


Screens 


Screenltems 


Screenltem 


The Screenltem object returns the result of access to the Screenltem list. 


Parent Object 


Picture containing the picture element. 


Usage 


The Screenltem object can be used to access the properties of graphic objects within a picture 
according to certain events. 
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The "Screenltem" object can be used for the following, for example: 


e To activate or deactivate the visualization of an object ("Visible" property). 


e To release or block the operation of an object ("Enabled" property). 


e Change the width and height of an object ("Height" and "Width" properties). 


e Change the position of an object ("Top" and "Left" properties). 


e Read and define a layer in which a graphic object is located ("Layer" property). 


e Read or define the name of a graphic object ("ObjectName" property). 


e Define a reference to the superordinate picture ("Parent" property). 


Using the "Activate" method, the focus is set on the respective Screenltem object. If the focus 
cannot be set because the object is non-operable, for example, an error is generated. Using 
error processing (On Error Resume Next), the error may be evaluated. 


Possible features of Screenltem 


The "Screenltem" object can contain the following object types: 


Standard ob- | Smart objects | Windows ob- | Tube objects | Controls Others 
jects jects 
Ellipse 3D bar Button Double T- Siemens HMI Customized Ob- 
piece Symbol Library ject 
Ellipse arc Application Check box Polygon WinCC AlarmCon- | Group 
window tube trol 
Ellipse seg- Bar Radio box Tube bend — | WinCC digital/ana- 
ment log clock control 
Circle Picture win- Round button | T-piece WinCC Function- 
dow TrendControl 
Circular arc Control Slider WinCC gauge con- 
trol 
Pie segment | I/O field WinCC Online- 
TrendControl 
Line Faceplate In- WinCC OnlineTa- 
stance bleControl 
Polygon Graphic ob- WinCC push but- 
ject ton control 
Polyline Combo box WinCC RulerCon- 
trol 
Rectangle List box WinCC slider con- 
trol 
Rounded rec- | Multiple row WinCC UserArchi- 
tangle text veControl 
Connector OLE object 
Group display 
Text list 
Status display 
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Detailed descriptions of the individual object types is provided under "Screenltem Object 
Types". The Screenltem object's "Type" property can be used to address the object types via 
the VBS Type ID. 


Object properties 


The "Screenltem" object has different properties according to the features. The following 
section describes the properties which all Screenltem object types have: 


Sub OnClick(ByVal Item) 

Dim obj 

Set obj = ScreenItems("Circlei"). 

End Sub =% Activate 


When a specific object type is addressed, certain further properties are added to the standard 
properties: 


Sub OnClick(ByVal Item) 
Dim obj 
Set obj = ScreenItems("Circlei") 
obj.| 
2B Activate 
ef BackColor 
e& BackF lashColorOff 
ef BackF lashColoron 
e BorderBackColor 


eS BorderColor 

ef BorderF lashColoroff 
e& BorderFlashColoroOn 
eS BorderStyle 

e& BorderWidth 


The additional properties are indicated in the descriptions of the individual object types. 
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Example 


In the following example, the radius of a circle is set to 2 in Runtime per mouse click: 


Sub OnClick(ByVal Item) 

"VBS5 

Dim objCircle 

Set objCircle= ScreenItems ("Circlel") 
objCircle.Radius = 2 

End Sub 


See also 
Width Property (Page 698) 
Visible Property (Page 696) 
Type Property (Page 666) 
Top Property (Page 643) 
Parent Property (Page 529) 
Left Property (Page 476) 
Layer Property (Page 460) 
Height Property (Page 443) 
Enabled Property (Page 408) 
Activate Method (Page 712) 
Example: How to Read Tag Values (Page 830) 
Example: Writing tag values (Page 828) 
Properties (Page 301) 
Objects and Lists (Page 107) 
Object types of the Screenltem object (Page 143) 
Object types of the Screenltem object (Page 143) 
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1.14.2.17 Screenltems Object (List) 


Description 


Screens 


Screen 


Screenltems 


Screenltem 


The "Screenltems" list can be used to reference an object in the picture. 


Parent Object 
Picture containing the picture element. 


Usage 
The "Screenltems" list can be used to: 
e To display or edit all objects in the list (i.e. all objects within a picture) ("_NewEnum" 
property). 
e To count the objects in a picture ("Count" property). 
e To process a specific object in the list ("Item" method). 


The properties are standard properties and methods of a collection and are not described in 
detail in the WinCC documentation. 


Special features of the Screenltem object 


If an external control (ActiveX control or OLE object) is embedded in WinCC, it is possible that 
the properties of the embedded controls have the same name with the general properties of 
the Screenltem object. In such cases, the Screenltem properties have priority. 


The properties of the embedded controls can also be addressed via the "object" property: 


The "object" property is only provided by ActiveX controls and OLE objects. 
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Example: 


"Controll is an embedded ActiveX-Control with property "type" 
"VBS196 

Dim Control 

Set Control=ScreenItems ("Controlli") 

Control.object.type 


'Controll is a WinCC-Control 
'VBS197 

Dim Control 

Set Control=ScreenItems ("Controlli") 
Control.type 


Example 


In the following example, the name of the objects in the current picture are displayed in a 
message box: 


Sub OnClick(ByVal Item) 
"VBS6 
Dim lngAnswer 
Dim lIngIndex 
IngIndex = 1 


For IngIndex = 1 To ScreenItems.Count 
IngAnswer = MsgBox (ScreenlItems (lngIndex) .Objectname, vbOKCancel) 
If vbCancel = lngAnswer Then Exit For 
ext 
End Sub 
See also 


Count Property (Page 393) 

Example: How to Read Tag Values (Page 830) 
Example: Writing tag values (Page 828) 
Screenltem Object (Page 125) 

Parent Property (Page 529) 

Item Method (Page 770) 

Object types of the Screenltem object (Page 143) 
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1.14.2.18 Screen Object 


Description 


HMIRuntime 


Screen ActiveScreenltem 
Screenltems 
Screenltem 
DataSet 
Dataltem 


The Screen object returns the result of access to the Screen list. All the properties and methods 
of this object can also be edited directly in Runtime. The "Screen" object represents a WinCC 
picture in Runtime and contains all the properties of the picture document and picture view. 


The "Screen" object also contains the following: 


e Alist of all the graphic objects contained in the addressed picture which can be addressed 
by the "Screenltems" object. 


e A list of all the layers contained in the addressed picture which can be addressed by the 
"Layers" object. 


Parent Object 
A picture window in which the Screen object is embedded. 


When the Screen object is the basic picture, the Parent object is not defined and set to zero. 


Usage 
The "Screen" object can be used for the following, for example: 
e To release or block the operation of a screen ("Enabled" property). 


e Change the width and height of a screen ("Height" and "Width" properties). 
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@ Zoom a picture ("Zoom" property). 


e Modify the fill pattern, background color and fill pattern color ("Fillstyle", "Backcolor" and 
"Fillcolor" properties). 


Note 


If a Change Picture is executed, all the open references are invalid for pictures no longer 
open. It is then no longer possible to work with these references. 


Example: 
In the following example, the width of the first picture in Runtime is increased by 20 pixels: 
"VBS7 
Dim objScreen 
Set objScreen = HMITRuntime.Screens (1) 
MsgBox "Screen width before changing: " & objScreen.Width 
objScreen.Width = objScreen.Width + 20 
MsgBox "Screen width after changing: " & objScreen.Width 


Notes on Cross References 
All the pictures which are addressed with the standard formulation 


HMIRuntime.BaseScreenName = "Screennam 


are automatically compiled by the CrossReference of WinCC and then listed in the picture 
properties. 


If pictures are addressed with different formulations in the code, this can be notified by the 
following section of the CrossReference: 


' ' WINCC:SCREENNAME SECTION START 
Const ScreenNameInAction = "ScreenName" 
" WINCC: SCREE AME SECTION END 


The section can be inserted in VBS actions as often as required. 


Note 


Always enter picture names without the extension "PDL" for reasons of compatibility with future 
versions. 


See also 
Screenltems Property (Page 561) 
Refresh Method (Page 788) 
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Activate Method (Page 712) 

Zoom Property (Page 709) 

Width Property (Page 698) 

Parent Property (Page 529) 
ObjectSizeDeclutteringMin Property (Page 515) 
ObjectSizeDeclutteringMax Property (Page 514) 
ObjectSizeDeclutteringEnable Property (Page 513) 
ObjectName Property (Page 512) 

Layers Property (Page 476) 

DataSet Property (Page 398) 
LayerDeclutteringEnable Property (Page 475) 
Height Property (Page 443) 

FillStyle Property (Page 419) 

FillColor Property (Page 418) 
ExtendedZoomingEnable Property (Page 416) 
Enabled Property (Page 408) 

BackColor Property (Page 322) 
ActiveScreenltem Property (Page 304) 
AccessPath Property (Page 302) 
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1.14.2.19 


Description 


Usage 
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Screens Object (List) 


HMIRuntime 


Screen ActiveScreenltem 
Screenltems 
Screenltem 
DataSet 
Dataltem 


By using the picture window technique, several windows can be opened simultaneously in 
WinCC Runtime but only one basic picture exists. The "Screens" list enables access to all 
open pictures in Runtime using the picture names. The Screens list contains all invisible 
pictures. 


When configuring a multi-user project, it is essential to specify the server prefix to access a 
picture which is not on the local computer. 


The "Screens" list can be used to: 

e@ Display or edit all the pictures within the list ("_NewEnum" property). 
¢ To count the pictures in a project ("Count" property). 

e@ To process a specific picture in the list ("Item" method). 

@ Initiate new drawing of all visible pictures ("Refresh" method). 


The properties are standard properties and methods of a collection and are not described in 
detail in the WinCC documentation. 


The access code, required in the VBS environment in the 
HM IRuntime.Screens(<Zugriffsschlussel>) instruction, must fulfill the syntax requirements: 


[<Grundbildname>.]<Bildfenstername>[:<Bildname>] 


.<Bildfenstername>[:<Bildname>] 
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This means: 

@ The access code expresses the picture hierarchy. 

e@ The picture names in the code can be omitted at any point. 

e The "AccessPath" property of the "Screen" object corresponds to the full access code. 


e Always enter picture names without the extension "PDL" for reasons of compatibility with 
future versions. 


e The basic picture can be addressed by the access code ". 


In addition, it has been defined that the basic picture can be addressed with Index 1. 


Examples 
The pictures are addressed by the hierarchy information in the list. There are two options here, 
with or without use of the picture name. In the following examples, a basic picture 
"BaseScreenName"’ is configured with a picture window "ScreenWindow". The picture window 
contains the picture "ScreenName". 
Addressing with the picture name 
'VBS8 


Set objScreen = HMITRuntime.Screens ("BaseScreenName.ScreenWindow: ScreenName") 


Addressing without the picture name 


"VBS9 
Set objScreen = HMITRuntime.Screens ("ScreenWindow") 


Referencing the basic picture in various ways 


"VBS10 
Set objScreen = HMTRuntime.Screens (1) 


"VBS11 
Set objScreen = HMTRuntime.Screens("") 


"VBS12 
Set objScreen = HMITRuntime.Screens ("BaseScreenName") 


See also 
Screenltem Object (Page 125) 
Refresh Method (Page 788) 
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1.14.2.20 


Description 


Usage 


Example 1 
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Item Method (Page 770) 
Count Property (Page 393) 


SmartTags Object 


The "HMIRuntime" component was deactivated in the faceplate type. The new "SmartTags" 
component was added for the faceplate type. With the SmartTags object you can dynamize 
the faceplate type. You can only access the faceplate variables and the properties of the 
faceplate type. You cannot access the normal WinCC tag management system. The normal 
WinCC tag management system is not available in the faceplate type. 


Using the "SmartTags" object, you can: 


e Access the faceplate tags in a faceplate type. 
Syntax: SmartTags("<tagname>") 


e Access the properties of a faceplate type. 
Syntax: SmartTags("Properties\<propertyname>") 


Insert a rectangle and a button in a faceplate type. Define a faceplate variable var1. Connect 
the "Width" property of the rectangle to faceplate variable var1. Dynamize the "OnClick" event 
of the button as follows with VBS. 


"VBS306 

Dim w 

w = SmartTags ("varl") 
w= w+ 10 
SmartTags("varl") =w 


When you activate Runtime, the faceplate variable is incremented by 10 every time you click 
the button. This increases the rectangle width by 10. 


Direct reading and writing with object reference 


In the following example, the SmartTags object is used to create an object reference "w" to 
"vari". 


Referencing offers the advantage of being able to access the "var1" tag. 


"VBS307 

Dim w 

Set w = SmartTags ("varl") 
w.value = w.value + 10 
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Example 2: 


Insert a rectangle and a button in a faceplate type. Define the instance-specific property "wide". 
Link the "Width" property of the rectangle to the instance-specific property "wide". Dynamize 
the "OnClick" event of the button as follows with VBS: 


'VBS308 

Dim w 

w = SmartTags ("Properties\wide") 
SmartTags ("Properties\wide") = w + 50 


When you activate Runtime, the instance-specific property "wide" is increased by 50 every 
time you click the button. This increases the rectangle width by 50. 


See also 
SmartTag property (Page 580) 


1.14.2.21 Tag Object 


Description 


HMIRuntime 


TagSet 


Tag 

A tag object is returned via the "Tags" list. A tag object can be used to address all the properties 
and methods of a tag. 

When creating a tag object, all the properties are installed with the following values: 

e Value = VT_EMPTY 

e Name = Tag name 

© QualityCode = BAD NON-SPECIFIC 

e TimeStamp = 0 

e LastError = 0 


e ErrorDescription ="" 


Note 


A summary of possible Quality Codes may be found in WinCC Information System under 
key word "Communication" > "Diagnostics" or "Communication" > "Quality Codes". 
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Usage 

The "Tag" object can be used to: 

@ Read out information on the tag ("Name", "QualityCode", "TimeStamp", "LastError" and 
"ErrorDescription" properties) 

@ Seta value for a tag ("Write" method, "Value" property) 

e Read a value for a tag ("Read" method, "Value" property) 

Read the value of a "Tag1" tag: 

'VBS13 


Dim objTag 

Set objTag = HMIRuntime.Tags ("Tagl") 
objTag.Read() 

MsgBox objTag.Value 


Declaration of tags in WinCC 
Always define internal tags in VB script using the "Dim" instruction in order to prevent writing 
tags wrongly. 
When creating a new action, the "Option explicit" instruction is automatically entered in the 
declaration area and cannot be deleted. 


Do not use the "Option explicit" instruction in the code because it may cause Runtime errors. 


Example: Declaration of a VBScript "IngVar" tag: 


"'VBS14 
Dim lngVar 
IngVar = 5 


MsgBox lIngVar 


Note 
Tag names must not contain any special characters. 


Please note that when creating a tag, it must not contain a value (Value = VT_EMPTY). Initialize 
the tags after declaration with the corresponding value. 


Notes on Cross References 
All the pictures which are addressed with the standard formulation 


HMTRuntime.Tags ("Tagname") 
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are automatically compiled by the CrossReference of WinCC and then listed in the picture 
properties. 


If tags are addressed with different formulations in the code, this can be notified by the following 
section of the CrossReference: 


' ' WINCC: TAGNAME SECTION START 


Const TagNameInAction = "TagName" 
' WINCC: TAGNAME SECTION END 


The section can be inserted in VBS actions as often as required. 


Note 


Itis not possible to guarantee the compilation of combined tag names from the CrossReference. 


See also 
Name Property (Page 509) 
Example: How to Read Tag Values (Page 830) 
Example: Writing tag values (Page 828) 
Write Method (Page 813) 
Read Method (Page 783) 
Value Property (Page 680) 
TimeStamp Property (Page 622) 
QualityCode Property (Page 546) 
LastError Property (Page 459) 
ErrorDescription Property (Page 411) 
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1.14.2.22 


Description 


Usage 


Tags Object (List) 


HMIRuntime 


The "Tags" list enables access to tags in WinCC Runtime. The result of access to the "Tags" 
list is returned by an object of the type "Tag". The Tag object can be used to access all the tag 
properties and methods. 


Note 


"Tags" is a list with a restricted functional scope. The tags in the list cannot be accessed via 
the index but only by using the tag names. The standard methods get_Count and 
get_NewEnum cannot be used in the Tags list. 


Tags in the list are accessed via: 


HMTRuntime.Tags ("Tagname") 


Example: 


140 


The Tags list is used to declare tags (tag objects) for read and write access. To ensure that 
read and write access is carried out without errors, the corresponding tags must be available 
in WinCC tag management. 


In VBS you can address tags directly via the name and set and read values. If you want to 
access additional tag properties, request the quality code, for example, you will always have 
to address tags via the tag listing. The tag object returned enables access to all tag properties 
and methods. You have to form an instance for the object, to write a binary tag with 

HM IRuntime.Tags("Variable").Value=TRUE, for example. 


The "CreateTagSet" method can be used to generate a "TagSet" object that enables 
simultaneous access to several tags. 


There are two options when creating tags: 


e With specification of the server prefix: For tags in multi-user systems which are not stored 
locally. 


e Direct use of the tag name: For tags stored locally on the computer. 
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Specification of the server prefix 


"'VBS15 
Dim objTag 


Set objTag = HMIRuntime.Tags ("Serverprefix::Tagname") 
If the server prefix is entered directly, the "ServerPrefix" property is assigned the 
corresponding value. 


Specification of the tag name 


"VBS16 
Dim objTag 


Set objTag = HMIRuntime.Tags ("Tagname") 
If just the tag name is used, the "ServerPrefix" and "TagPrefix" properties are assigned 
the values from the current context (current picture window). 


See also 


Example: How to Read Tag Values (Page 830) 


Example: Writing tag values (Page 828) 
Item Method (Page 770) 

CreateTagSet Method (Page 717) 

Tag Object (Page 137) 


1.14.2.23  TagSet Object (List) 


Description 


The object "TagSet" enables simultaneous access to several tags in one call. This features 
better performance and lower communication load that single access to various tags. 


Usage 


Using the TagSet object, you may: 


Add tags to the list ("Add" method) 

Access tag objects contained in the list, and their properties ("Item" method) 
Write all tags of the list ("Write" method) 

Read all tags of the list ("Read" method) 

Remove single tags from the list ("Remove" method) 


Remove all tags from the list ("RemoveAll" method) 
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Tags in the list are accessed via: 


"VBS169 

Dim myTags 

myTags = HMIRuntime.Tags.CreateTagSet 
myTags ("Tagname") 


In order to have error-free read/write access to tags (tag objects) of the list, the respective tags 


must exist in WinCC tag management. 


If an error occurred during read/write access, the method used will return an error message 


using the "LastError" and "ErrorDescription" properties. 


Synchronous writing and reading of the tags is possible. The optional "Writemode" parameter 
can be used to write process tags directly to the AS with "1", for example, "group.Write 1". Use 
the optional "Readmode" parameter to read process tags with "1" directly from the AS or 


channel, for example, "group.Read 1". 


Example: 


The following example shows how to generate a TagSet object, how to add tags, and how to 


write values. 


'VBS168 

Build a Reference to the TagSet Object 
Dim group 

Set group = HMIRuntime.Tags.CreateTagSet 
"Add Tags to the Collection 

group.Add "Motor1" 

group.Add "Motor2" 

"Set the Values of the Tags 

group ("Motorl1").Value = 3 

group ("Motor2").Value = 9 

‘Write the Values to the DataManager 
group.Write 


See also 
LastError Property (Page 459) 
Example: How to Read Tag Values (Page 830) 
Example: Writing tag values (Page 828) 
Write Method (Page 813) 
RemoveAll Method (Page 792) 
Remove Method (Page 789) 
Read Method (Page 783) 
Item Method (Page 770) 


142 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


VBS for Creating Procedures and Actions 
7.14 VBS Reference 


ErrorDescription Property (Page 411) 
Count Property (Page 393) 

Add Method (Page 713) 

Tags Object (List) (Page 140) 

Tag Object (Page 137) 


1.14.3 Object types of the Screenltem object 
1.14.3.1 Object types of the Screenltem object 
Introduction 


The following section lists all the available types of the "Screenltem" object. 


The features of the "Screenltem" object represent all the graphic objects available in WinCC 
Graphics Designer. 


The object types are divided into the following groups according to their arrangement in 
Graphics Designer: 


e@ Standard objects 

@ Smart objects 

@ Windows objects 

e@ Tube objects 

e Controls 

There are also the object types 
@ Customized Object 


e Group 


See also 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Group (Page 300) 
Customized Object (Page 298) 
Controls (Page 218) 
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1.14.3.2 Standard objects 


Ellipse 


Description 


Screens 


Screen 


Screenltems 


Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Ellipse" 


Type Identifier in VBS 
HMIEllipse 


Usage 


In the following example, the object with the name "Ellipse1" is moved 10 pixels to the right: 


"VBS17 

Dim objEllipse 

Set objEllipse = ScreenItems ("Ellipsel") 
objEllipse.Left = objEllipse.Left + 10 


See also 
FillStyle Property (Page 419) 
Activate Method (Page 712) 
Properties (Page 301) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Width Property (Page 698) 
Visible Property (Page 696) 
Type Property (Page 666) 
Top Property (Page 643) 
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ToolTipText Property (Page 641) 
RadiusWidth Property (Page 548) 
RadiusHeight Property (Page 547) 
PasswordLevel Property (Page 530) 
Parent Property (Page 529) 

ObjectName Property (Page 512) 

Left Property (Page 476) 

Layer Object (Page 120) 

Height Property (Page 443) 
FlashRateBorderColor Property (Page 427) 
FlashRateBackColor Property (Page 427) 
FlashBorderColor Property (Page 424) 
FlashBackColor Property (Page 423) 
Fillinglndex Property (Page 419) 

Filling Property (Page 419) 

FillColor Property (Page 418) 

Enabled Property (Page 408) 
BorderWidth Property (Page 355) 
BorderStyle Property (Page 355) 
BorderFlashColorOn Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
BorderColor Property (Page 353) 
BorderBackColor Property (Page 353) 
BackFlashColorOn Property (Page 324) 
BackFlashColorOff Property (Page 324) 
BackColor Property (Page 322) 

Layer Property (Page 460) 
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Ellipse arc 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Ellipse Arc" 


Type Identifier in VBS 


Usage 


'VBS18 


HMIEllipticalArc 


In the following example, the object with the name "EllipseArc1" is moved 10 pixels to the right: 


Dim objEllipseArc 
Set objEllipseArc = ScreenItems ("EllipseArcl") 
objEllipseArc.Left = objEllipseArc.Left + 10 


See also 
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RadiusHeight Property (Page 547) 
Activate Method (Page 712) 
Properties (Page 301) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Width Property (Page 698) 

Visible Property (Page 696) 

Type Property (Page 666) 

Top Property (Page 643) 
ToolTipText Property (Page 641) 
StartAngle Property (Page 587) 
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RadiusWidth Property (Page 548) 
PasswordLevel Property (Page 530) 
Parent Property (Page 529) 

ObjectName Property (Page 512) 

Left Property (Page 476) 

Layer Object (Page 120) 

Height Property (Page 443) 
FlashRateBorderColor Property (Page 427) 
FlashBorderColor Property (Page 424) 
EndAngle Property (Page 409) 

Enabled Property (Page 408) 
BorderWidth Property (Page 355) 
BorderStyle Property (Page 355) 
BorderFlashColorOn Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
BorderColor Property (Page 353) 
BorderBackColor Property (Page 353) 
Layer Property (Page 460) 


Ellipse segment 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Ellipse Segment" 


Type Identifier in VBS 
HMIEllipseSegment 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 147 


VBS for Creating Procedures and Actions 
7.14 VBS Reference 


Usage 


In the following example, the object with the name "EllipseSegment1" is moved 10 pixels to 
the right: 


"VBS19 

Dim objEllipseSeg 

Set objEllipseSeg = ScreenItems ("EllipseSegment1") 
objEllipseSeg.Left = objEllipseSeg.Left + 10 


See also 
Layer Object (Page 120) 
Activate Method (Page 712) 
Properties (Page 301) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Width Property (Page 698) 
Visible Property (Page 696) 
Type Property (Page 666) 
Top Property (Page 643) 
ToolTipText Property (Page 641) 
StartAngle Property (Page 587) 
RadiusWidth Property (Page 548) 
RadiusHeight Property (Page 547) 
PasswordLevel Property (Page 530) 
Parent Property (Page 529) 
ObjectName Property (Page 512) 
Left Property (Page 476) 
Height Property (Page 443) 
FlashRateBorderColor Property (Page 427) 
FlashRateBackColor Property (Page 427) 
FlashBorderColor Property (Page 424) 
FlashBackColor Property (Page 423) 
FillStyle Property (Page 419) 
Fillinglndex Property (Page 419) 
Filling Property (Page 419) 
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FillColor Property (Page 418) 

EndAngle Property (Page 409) 

Enabled Property (Page 408) 
BorderWidth Property (Page 355) 
BorderStyle Property (Page 355) 
BorderFlashColorOn Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
BorderColor Property (Page 353) 
BorderBackColor Property (Page 353) 
BackFlashColorOn Property (Page 324) 
BackFlashColorOff Property (Page 324) 
BackColor Property (Page 322) 

Layer Property (Page 460) 


Circle 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Circle". 


Type Identifier in VBS 
HMICircle 


Usage 
In the following example, the object with the name "Circle1" is moved 10 pixels to the right: 


"VBS20 

Dim objCircle 

Set objCircle= ScreenItems ("Circlel") 
objCircle.Left = objCircle.Left + 10 
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See also 
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Properties (Page 301) 

BorderStyle Property (Page 355) 

Activate Method (Page 712) 

Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 

Width Property (Page 698) 

Visible Property (Page 696) 

Type Property (Page 666) 

Top Property (Page 643) 

ToolTipText Property (Page 641) 

Radius Property (Page 547) 
PasswordLevel Property (Page 530) 
Parent Property (Page 529) 

ObjectName Property (Page 512) 

Left Property (Page 476) 

Layer Object (Page 120) 

Height Property (Page 443) 
FlashRateBorderColor Property (Page 427) 
FlashRateBackColor Property (Page 427) 
FlashBorderColor Property (Page 424) 
FlashBackColor Property (Page 423) 
FillStyle Property (Page 419) 

Fillinglndex Property (Page 419) 

Filling Property (Page 419) 

FillColor Property (Page 418) 

Enabled Property (Page 408) 
BorderWidth Property (Page 355) 
BorderFlashColorOn Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
BorderColor Property (Page 353) 
BorderBackColor Property (Page 353) 
BackFlashColorOn Property (Page 324) 
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BackFlashColorOff Property (Page 324) 
BackColor Property (Page 322) 
Layer Property (Page 460) 


Circular arc 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Circular Arc" 


Type Identifier in VBS 
HMICircularArc 


Usage 
In the following example, the object with the name "CircularArc1" is moved 10 pixels to the 
right: 

'VBS21 

Dim objCircularArc 

Set objCircularArc = ScreenlItems ("CircularArcl") 


objCircularArc.Left = objCircularArc.Left + 10 


See also 
StartAngle Property (Page 587) 
Activate Method (Page 712) 
Properties (Page 301) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Width Property (Page 698) 
Visible Property (Page 696) 
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Type Property (Page 666) 

Top Property (Page 643) 

ToolTipText Property (Page 641) 

Radius Property (Page 547) 
PasswordLevel Property (Page 530) 
Parent Property (Page 529) 

ObjectName Property (Page 512) 

Left Property (Page 476) 

Layer Object (Page 120) 

Height Property (Page 443) 
FlashRateBorderColor Property (Page 427) 
FlashBorderColor Property (Page 424) 
EndAngle Property (Page 409) 

Enabled Property (Page 408) 
BorderWidth Property (Page 355) 
BorderStyle Property (Page 355) 
BorderFlashColorOn Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
BorderColor Property (Page 353) 
BorderBackColor Property (Page 353) 
Layer Property (Page 460) 


Pie segment 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Pie Segment" 
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Type Identifier in VBS 
HMICircleSegment 


Usage 


In the following example, the object with the name "PieSegmenti" is moved 10 pixels to the 
right: 


"VBS22 

Dim objCircleSeg 

Set objCircleSeg = ScreenItems ("PieSegment1") 
objCircleSeg.Left = objCircleSeg.Left + 10 


See also 
Type Property (Page 666) 
BorderColor Property (Page 353) 
Activate Method (Page 712) 
Properties (Page 301) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Width Property (Page 698) 
Visible Property (Page 696) 
Top Property (Page 643) 
ToolTipText Property (Page 641) 
StartAngle Property (Page 587) 
Radius Property (Page 547) 
PasswordLevel Property (Page 530) 
Parent Property (Page 529) 
ObjectName Property (Page 512) 
Left Property (Page 476) 
Layer Object (Page 120) 
Height Property (Page 443) 
FlashRateBorderColor Property (Page 427) 
FlashRateBackColor Property (Page 427) 
FlashBorderColor Property (Page 424) 
FlashBackColor Property (Page 423) 
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Line 


Description 


FillStyle Property (Page 419) 

Fillinglndex Property (Page 419) 

Filling Property (Page 419) 

FillColor Property (Page 418) 

EndAngle Property (Page 409) 

Enabled Property (Page 408) 
BorderWidth Property (Page 355) 
BorderStyle Property (Page 355) 
BorderFlashColorOn Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
BorderBackColor Property (Page 353) 
BackFlashColorOn Property (Page 324) 
BackFlashColorOff Property (Page 324) 
BackColor Property (Page 322) 

Layer Property (Page 460) 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Line" 


Type Identifier in VBS 
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HMILine 
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Usage 


'VBS23 

Dim objLine 
Set objLine 
objLine.Left 


See also 


7.14 VBS Reference 


In the following example, the object with the name "Line1" is moved 10 pixels to the right: 


ScreenItems ("Linel") 
objLine.Left + 10 


PasswordLevel Property (Page 530) 
Activate Method (Page 712) 

Properties (Page 301) 

Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 

Width Property (Page 698) 

Visible Property (Page 696) 

Type Property (Page 666) 

Top Property (Page 643) 

ToolTipText Property (Page 641) 
RotationAngle Property (Page 552) 
ReferenceRotationTop Property (Page 549) 
ReferenceRotationLeft Property (Page 549) 
Parent Property (Page 529) 

ObjectName Property (Page 512) 

Left Property (Page 476) 

Layer Object (Page 120) 

Height Property (Page 443) 
FlashRateBorderColor Property (Page 427) 
FlashBorderColor Property (Page 424) 
Enabled Property (Page 408) 

BorderWidth Property (Page 355) 
BorderStyle Property (Page 355) 
BorderFlashColorOn Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
BorderEndStyle Property (Page 354) 
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BorderColor Property (Page 353) 
BorderBackColor Property (Page 353) 
Layer Property (Page 460) 


Polygon 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Polygon" 


Type Identifier in VBS 
HMIPolygon 


Usage 
In the following example, the object with the name "Polygon1" is moved 10 pixels to the right: 


'VBS24 

Dim objPolygon 

Set objPolygon = ScreenItems ("Polygonl") 
objPolygon.Left = objPolygon.Left + 10 


See also 
ReferenceRotationTop Property (Page 549) 
BackFlashColorOn Property (Page 324) 
Activate Method (Page 712) 
Properties (Page 301) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Width Property (Page 698) 
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Visible Property (Page 696) 

Type Property (Page 666) 

Top Property (Page 643) 

ToolTipText Property (Page 641) 
RotationAngle Property (Page 552) 
ReferenceRotationLeft Property (Page 549) 
PointCount Property (Page 541) 
PasswordLevel Property (Page 530) 
Parent Property (Page 529) 

ObjectName Property (Page 512) 

Left Property (Page 476) 

Layer Object (Page 120) 

Index Property (Page 452) 

Height Property (Page 443) 
FlashRateBorderColor Property (Page 427) 
FlashRateBackColor Property (Page 427) 
FlashBorderColor Property (Page 424) 
FlashBackColor Property (Page 423) 
FillStyle Property (Page 419) 

Fillinglndex Property (Page 419) 

Filling Property (Page 419) 

FillColor Property (Page 418) 

Enabled Property (Page 408) 
BorderWidth Property (Page 355) 
BorderStyle Property (Page 355) 
BorderFlashColorOn Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
BorderColor Property (Page 353) 
BorderBackColor Property (Page 353) 
BackFlashColorOff Property (Page 324) 
BackColor Property (Page 322) 
ActualPointTop Property (Page 306) 
ActualPointLeft Property (Page 305) 
Layer Property (Page 460) 
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Polyline 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Polyline" 


Type Identifier in VBS 


Usage 


"VBS25 


Dim objPolyline 
Set objPolyline 


HMIPolyLine 


In the following example, the object with the name "Polyline1" is moved 10 pixels to the right: 


= ScreenlItems("Polylinel") 


objPolyline.Left = objPolyline.Left + 10 


See also 
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Layer Object (Page 120) 

Activate Method (Page 712) 
Properties (Page 301) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Width Property (Page 698) 

Visible Property (Page 696) 

Type Property (Page 666) 

Top Property (Page 643) 
ToolTipText Property (Page 641) 
RotationAngle Property (Page 552) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


VBS for Creating Procedures and Actions 
7.14 VBS Reference 


ReferenceRotationTop Property (Page 549) 
ReferenceRotationLeft Property (Page 549) 
PointCount Property (Page 541) 
PasswordLevel Property (Page 530) 
Parent Property (Page 529) 

ObjectName Property (Page 512) 

Left Property (Page 476) 

Index Property (Page 452) 

Height Property (Page 443) 
FlashRateBorderColor Property (Page 427) 
FlashBorderColor Property (Page 424) 
Enabled Property (Page 408) 

BorderWidth Property (Page 355) 
BorderStyle Property (Page 355) 
BorderFlashColorOn Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
BorderEndStyle Property (Page 354) 
BorderColor Property (Page 353) 
BorderBackColor Property (Page 353) 
ActualPointTop Property (Page 306) 
ActualPointLeft Property (Page 305) 

Layer Property (Page 460) 


Rectangle 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Rectangle" 
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Type Identifier in VBS 


Usage 


"VBS26 


HMIRectangle 


In the following example, the object with the name "Rectangle1" is moved 10 pixels to the right: 


Dim objRectangle 


Set objRectangl 


= ScreenItems ("Rectanglel") 


-Left = objRectangle.Left + 10 


objRectangl 


Notes on Error Handling 


The rectangle and rounded rectangle are mapped to an "HMIRectangle" type in the object 
model. Since the two objects have different properties, the availability of the property (dynamic 
type compilation in Runtime) should be queried via an exception measure. The exception 
measure is activated for the corresponding procedure by the following instruction: 


On Error Resume Next 


On Error Goto 0 
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The instruction causes the VBScript engine to initiate the follow-on command in the case of a 
Runtime error. 


The error code can subsequently be checked using the Err object. In order to deactivate the 
handling of Runtime errors in scripts, use the following command: 


Handling errors always relates to the procedure layer. If a script in a procedure causes an 
error, VBScript checks whether an error handling measure is implemented in this layer. If not, 
control is transferred one layer up (to the calling procedure). If there is no error handling 
measure here either, the control is transferred yet another layer up. This continues until either 
the top module level is reached or the code for Runtime error handling is located. If the 
activation of the Runtime error handling fails, the control is transferred to the top level on the 
internal VBScript Runtime error handing. This opens an error dialog and stops the script. 


The "On Error Resume Next" command can be installed on all layers (i.e. also in procedures). 
When the error handling measure is use, it can basically be determined whether the user is 
actually using the required implementation type. 


In addition, it can be ensured that there is no termination of execution due to a faulty access 
to the object. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


VBS for Creating Procedures and Actions 


Examples of error handling 


Sub OnClick(ByVal Item) 


"VBS27 


Dim objScreenItem 


"Activation of errorhandling: 

On Error Resume Next 

For Each objScreenItem In ScreenItems 

If "HMIRectangle" = objScreenItem.Type Then 


7.14 VBS Reference 


‘=== Property "RoundCornerHeight" only available for RoundRectangle 
objScreenItem.RoundCornerHeight = objScreenItem.RoundCornerHeight * 2 


If 0 <> 


"Delet 


Err.Number Then 
HMTRuntime.Trace objScreenItem.Name & ": 


End If 
End If 
ext 


End Sub 


See also 


rror messag 


Err.Clear 


On Error Goto 0 ‘Deactivation of errorhandling 


Properties (Page 301) 
BorderFlashColorOn Property (Page 355) 
Activate Method (Page 712) 

Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 

Width Property (Page 698) 

Visible Property (Page 696) 

Type Property (Page 666) 

Top Property (Page 643) 

ToolTipText Property (Page 641) 
PasswordLevel Property (Page 530) 
Parent Property (Page 529) 

ObjectName Property (Page 512) 

Left Property (Page 476) 

Layer Object (Page 120) 

Height Property (Page 443) 
FlashRateBorderColor Property (Page 427) 
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FlashRateBackColor Property (Page 427) 
FlashBorderColor Property (Page 424) 
FlashBackColor Property (Page 423) 
FillStyle Property (Page 419) 

Fillinglndex Property (Page 419) 

Filling Property (Page 419) 

FillColor Property (Page 418) 

Enabled Property (Page 408) 
BorderWidth Property (Page 355) 
BorderStyle Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
BorderColor Property (Page 353) 
BorderBackColor Property (Page 353) 
BackFlashColorOn Property (Page 324) 
BackFlashColorOff Property (Page 324) 
BackColor Property (Page 322) 

Layer Property (Page 460) 


Rounded rectangle 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Rounded Rectangle". 


Type Identifier in VBS 
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HMIRoundRectangle 
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Usage 


'VBS28 


7.14 VBS Reference 


In the following example, the object with the name "RoundedRectangle1" is moved 10 pixels 


to the right: 


Dim objRoundedRectangle 
Set objRoundedRectangle = ScreenItems ("RoundedRectanglel") 
objRoundedRectangle.Left = objRoundedRectangle.Left + 10 


Notes on Error Handling 


On 


Error Goto 0 


The rectangle and rounded rectangle are mapped to an "HMIRectangle" type in the object 
model. Since the two objects have different properties, the availability of the property (dynamic 
type compilation in Runtime) should be queried via an exception measure. The exception 
measure is activated for the corresponding procedure by the following instruction: 


Error Resume Next 


The instruction causes the VBScript engine to initiate the follow-on command in the case of a 
Runtime error. 


The error code can subsequently be checked using the Err object. In order to deactivate the 
handling of Runtime errors in scripts, use the following command: 


Handling errors always relates to the procedure layer. If a script in a procedure causes an 
error, VBScript checks whether an error handling measure is implemented in this layer. If not, 
control is transferred one layer up (to the calling procedure). If there is no error handling 
measure here either, the control is transferred yet another layer up. This continues until either 
the top module level is reached or the code for Runtime error handling is located. If the 
activation of the Runtime error handling fails, the control is transferred to the top level on the 
internal VBScript Runtime error handing. This opens an error dialog and stops the script. 


The "On Error Resume Next" command can be installed on all layers (i.e. also in procedures). 
When the error handling measure is use, it can basically be determined whether the user is 
actually using the required implementation type. 


In addition, it can be ensured that there is no termination of execution due to a faulty access 
to the object. 
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Examples of error handling 


Sub OnClick(ByVal Item) 
"VBS29 
Dim objScreenItem 


On Error Resume Next "Activation of errorhandling 
For Each objScreenItem In ScreenItems 
If "HMIRectangle" = objScreenItem.Type Then 


‘=== Property "RoundCornerHeight" available only for RoundRectangle 


objScreenItem.RoundCornerHeight = objScreenItem.RoundCornerHeight * 2 

If 0 <> Err.Number Then 

HMTRuntime.Trace objScreenItem.ObjectName & ": no RoundedRectangle" & vbCrLf 
Err.Clear "Delet rrormessag 

End If 

End If 

Next 

On Error Goto 0 "Deactivation of errorhandling 

End Sub 

See also 


FlashBackColor Property (Page 423) 
Activate Method (Page 712) 

Properties (Page 301) 

Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 

Width Property (Page 698) 

Visible Property (Page 696) 

Type Property (Page 666) 

Top Property (Page 643) 

ToolTipText Property (Page 641) 
RoundCornerWidth Property (Page 553) 
RoundCornerHeight Property (Page 553) 
PasswordLevel Property (Page 530) 
Parent Property (Page 529) 

ObjectName Property (Page 512) 

Left Property (Page 476) 

Layer Object (Page 120) 

Height Property (Page 443) 
FlashRateBorderColor Property (Page 427) 
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FlashRateBackColor Property (Page 427) 
FlashBorderColor Property (Page 424) 
FillStyle Property (Page 419) 

Fillinglndex Property (Page 419) 

Filling Property (Page 419) 

FillColor Property (Page 418) 

Enabled Property (Page 408) 
BorderWidth Property (Page 355) 
BorderStyle Property (Page 355) 
BorderFlashColorOn Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
BorderColor Property (Page 353) 
BorderBackColor Property (Page 353) 
BackFlashColorOn Property (Page 324) 
BackFlashColorOff Property (Page 324) 
BackColor Property (Page 322) 

Layer Property (Page 460) 


Static text 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Static Text" 


Type Identifier in VBS 
HMITextField 
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Usage 


'VBS30 
Dim objStaticl 


In the following example, the object with the name "StaticText1" is moved 10 pixels to the right: 


Text 
Set objStaticT 


xt = ScreenItems("StaticTextl1") 


objStaticText.Left = objStaticText.Left + 10 


See also 
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ObjectName Property (Page 512) 


BorderFlashColorOn Property (Page 355) 


Activate Method (Page 712) 
Properties (Page 301) 

Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 

Width Property (Page 698) 

Visible Property (Page 696) 

Type Property (Page 666) 

Top Property (Page 643) 
ToolTipText Property (Page 641) 
Text list (Page 196) 

PasswordLevel Property (Page 530) 
Parent Property (Page 529) 
Orientation Property (Page 526) 

Left Property (Page 476) 

Layer Object (Page 120) 

Height Property (Page 443) 
ForeFlashColorOn Property (Page 436) 
ForeFlashColorOff Property (Page 435) 
ForeColor Property (Page 435) 
FontUnderline Property (Page 434) 
FontSize Property (Page 433) 
FontName Property (Page 433) 
Fontltalic Property (Page 432) 
FontBold Property (Page 432) 
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Connector 


Description 


7.14 VBS Reference 


FlashRateForeColor Property (Page 428) 
FlashRateBorderColor Property (Page 427) 
FlashRateBackColor Property (Page 427) 
FlashForeColor Property (Page 424) 
FlashBorderColor Property (Page 424) 
FlashBackColor Property (Page 423) 
FillStyle Property (Page 419) 

Fillinglndex Property (Page 419) 

Filling Property (Page 419) 

FillColor Property (Page 418) 

Enabled Property (Page 408) 
BorderWidth Property (Page 355) 
BorderStyle Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
BorderColor Property (Page 353) 
BorderBackColor Property (Page 353) 
BackFlashColorOn Property (Page 324) 
BackFlashColorOff Property (Page 324) 
BackColor Property (Page 322) 
AlignmentTop Property (Page 310) 
AlignmentLeft Property (Page 309) 
AdaptBorder Property (Page 306) 

Layer Property (Page 460) 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Connector" 
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Type Identifier in VBS 


Usage 


"'VBS31 


HM IConnector 


In the following example, the object with the name "Connector1" is moved 10 pixels to the right: 


Dim objConnector 
Set objConnector = ScreenItems ("Connectorl") 
objConnector.Left = objConnector.Left + 10 


See also 
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Screenltems Object (List) (Page 129) 

Activate Method (Page 712) 

Properties (Page 301) 

Screenltem Object (Page 125) 

Width Property (Page 698) 

Visible Property (Page 696) 

Type Property (Page 666) 

TopConnectedObjectName Property (Page 644) 
TopConnectedConnectionPointIndex Property (Page 644) 
Top Property (Page 643) 

ToolTipText Property (Page 641) 

Parent Property (Page 529) 

Orientation Property (Page 526) 

ObjectName Property (Page 512) 

Left Property (Page 476) 

Layer Property (Page 460) 

Height Property (Page 443) 

Enabled Property (Page 408) 
BottomConnectedObjectName Property (Page 356) 
BottomConnectedConnectionPointIndex Property (Page 356) 
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1.14.3.3 Smart objects 


3D Bar 


Description 


Screens 


Screen 


Screenltems 


Screenltem 


Object Type of Screenltem Object. Represents the graphic object "3D Bar" 


Type Identifier in VBS 
HMIBar 


Usage 
In the following example, the object with the name "3DBar1" is moved 10 pixels to the right: 


"VBS32 


Dim objBar 
Set objBar = ScreenItems ("3DBarl1") 


objBar.Left = objBar.Left + 10 


Notes on Error Handling 
Bars and 3D bars are imaged in the object model on a "HMIBar" type. Since the two objects 


have different properties, the availability of the property (dynamic type compilation in Runtime) 
should be queried via an exception measure. The exception measure is activated for the 


corresponding procedure by the following instruction: 


On Error Resume Next 


The instruction causes the VBScript engine to initiate the follow-on command in the case of a 


Runtime error. 
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On Error Goto 0 


The error code can subsequently be checked using the Err object. In order to deactivate the 
handling of Runtime errors in scripts, use the following command: 


Handling errors always relates to the procedure layer. If a script in a procedure causes an 
error, VBScript checks whether an error handling measure is implemented in this layer. If not, 
control is transferred one layer up (to the calling procedure). If there is no error handling 
measure here either, the control is transferred yet another layer up. This continues until either 
the top module level is reached or the code for Runtime error handling is located. If the 
activation of the Runtime error handling fails, the control is transferred to the top level on the 
internal VBScript Runtime error handing. This opens an error dialog and stops the script. 


The "On Error Resume Next" command can be installed on all layers (i.e. also in procedures). 
When the error handling measure is use, it can basically be determined whether the user is 
actually using the required implementation type. 


In addition, it can be ensured that there is no termination of execution due to a faulty access 
to the object. 


Examples of error handling 


"VBS148 


Sub OnClick(ByVal Item) 
Dim objScreenItem 


"Activation of errorhandling: 

On Error Resume Next 

For Each objScreenItem In ScreenItems 
If "HMIBar" = objScreenItem.Type Then 


' 


‘=== Property "Layer00Value" only available for 3D bar 
objScreenItem.Layer00Value = objScreenItem.LayerO00Value * 2 
If 0 <> Err.Number Then 


HMTRuntime.Trace objScreenItem.Name & ": no 3D bar" & vbCrLf 
id 


"Delet rror messag 


Err.Clear 

End If 

End If 

ext 

On Error Goto 0 'Deactivation of errorhandling 
End Sub 


See also 
Type Property (Page 666) 
LayerO8Color Property (Page 467) 
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BorderStyle Property (Page 355) 
Activate Method (Page 712) 
Properties (Page 301) 

Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
ZeroPointValue Property (Page 709) 
Width Property (Page 698) 

Visible Property (Page 696) 

Top Property (Page 643) 

ToolTipText Property (Page 641) 
Process Property (Page 544) 
PredefinedAngles Property (Page 543) 
PasswordLevel Property (Page 530) 
Parent Property (Page 529) 
ObjectName Property (Page 512) 

Min Property (Page 506) 

Max Property (Page 488) 

LightEffect Property (Page 477) 

Left Property (Page 476) 
Layer10Value Property (Page 475) 
Layer09Value Property (Page 475) 
Layer08Value Property (Page 475) 
Layer07Value Property (Page 474) 
Layer06Value Property (Page 474) 
Layer05Value Property (Page 474) 
Layer04Value Property (Page 473) 
Layer03Value Property (Page 473) 
Layer02Value Property (Page 473) 
Layer01Value Property (Page 473) 
LayerO0OValue Property (Page 472) 
Layer10Color Property (Page 468) 
LayerO9Color Property (Page 468) 
Layer07Color Property (Page 467) 
LayerO6Color Property (Page 467) 
Layer05Color Property (Page 466) 
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Layer04Color Property (Page 466) 
Layer03Color Property (Page 466) 
Layer02Color Property (Page 465) 
Layer01Color Property (Page 465) 
LayerOOColor Property (Page 465) 
Layer10Checked Property (Page 464) 
Layer09Checked Property (Page 464) 
LayerO08Checked Property (Page 464) 
Layer07Checked Property (Page 463) 
LayerO06Checked Property (Page 463) 
Layer05Checked Property (Page 463) 
Layer04Checked Property (Page 462) 
Layer03Checked Property (Page 462) 
Layer02Checked Property (Page 462) 
Layer01 Checked Property (Page 461) 
LayerOOChecked Property (Page 461) 
Layer Object (Page 120) 

Height Property (Page 443) 
Enabled Property (Page 408) 
Direction Property (Page 405) 
BorderWidth Property (Page 355) 
BorderColor Property (Page 353) 
BaseY Property (Page 342) 
BaseX Property (Page 343) 
BarWidth Property (Page 340) 
BarHeight Property (Page 329) 
BarDepth Property (Page 328) 
Background Property (Page 324) 
BackColor Property (Page 322) 
Axe Property (Page 320) 
AngleBeta Property (Page 312) 
AngleAlpha Property (Page 312) 
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Application Window 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Application Window" 


Type Identifier in VBS 


Usage 


"VBS33 


HM|ApplicationWindow 


7.14 VBS Reference 


In the following example, the object with the name "ApplicationWindow1" is moved 10 pixels 


to the right: 


Dim objAppWindow 


Set objAppWindow = ScreenItems ("ApplicationWindow1") 


objAppWindow. Left = objAppWindow.Left + 10 


See also 


Properties (Page 301) 

Activate Method (Page 712) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
WindowBorder Property (Page 699) 
Width Property (Page 698) 

Visible Property (Page 696) 

Type Property (Page 666) 

Top Property (Page 643) 

Template Property (Page 598) 
Parent Property (Page 529) 
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OnTop Property (Page 517) 
ObjectName Property (Page 512) 
Moveable Property (Page 507) 
MaximizeButton Property (Page 488) 
Left Property (Page 476) 

Layer Object (Page 120) 

Height Property (Page 443) 
Enabled Property (Page 408) 
CloseButton Property (Page 371) 
Caption Property (Page 362) 
Application Property (Page 313) 


Bar 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Bar" 


Type Identifier in VBS 


HMIBar 
Usage 
In the following example, the object with the name "Bar1" is moved 10 pixels to the right: 
'VBS34 
Dim objBar 
Set objBar = ScreenItems ("Barl") 


objBar.Left = objBar.Left + 10 
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Notes on Error Handling 


On 


On 


Error Goto 0 


Bars and 3D bars are imaged in the object model on a "HMIBar" type. Since the two objects 
have different properties, the availability of the property (dynamic type compilation in Runtime) 
should be queried via an exception measure. The exception measure is activated for the 
corresponding procedure by the following instruction: 


Error Resume Next 


The instruction causes the VBScript engine to initiate the follow-on command in the case of a 
Runtime error. 


The error code can subsequently be checked using the Err object. In order to deactivate the 
handling of Runtime errors in scripts, use the following command: 


Handling errors always relates to the procedure layer. If a script in a procedure causes an 
error, VBScript checks whether an error handling measure is implemented in this layer. If not, 
control is transferred one layer up (to the calling procedure). If there is no error handling 
measure here either, the control is transferred yet another layer up. This continues until either 
the top module level is reached or the code for Runtime error handling is located. If the 
activation of the Runtime error handling fails, the control is transferred to the top level on the 
internal VBScript Runtime error handing. This opens an error dialog and stops the script. 


The "On Error Resume Next" command can be installed on all layers (i.e. also in procedures). 
When the error handling measure is use, it can basically be determined whether the user is 
actually using the required implementation type. 


In addition, it can be ensured that there is no termination of execution due to a faulty access 
to the object. 
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Examples of error handling 


"VBS147 


Sub OnClick(ByVal Item) 
Dim objScreenItem 


"Activation of errorhandling: 


On Error Resume 


Next 


For Each objScreenItem In ScreenItems 
If "HMIBar" = objScreenItem.Type Then 


‘=== Property "LimitHigh4" only available for bar 


objScreenItem.L 


imitHigh4 = objScreenItem.LimitHigh4 * 2 


If 0 <> Err.Number Then 


HMTRuntime.Trace objScreenItem.Name & ": 


Err.Clear 

End. TE 

End If 

ext 

On Error Goto 0 
End Sub 


See also 
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"Delet rror messag 


"Deactivation of errorhandling 


ToolTipText Property (Page 641) 

Layer Object (Page 120) 
ColorChangeType Property (Page 375) 
Average Property (Page 320) 

Activate Method (Page 712) 

Properties (Page 301) 

Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
ZeroPointValue Property (Page 709) 
ZeroPoint Property (Page 709) 

Width Property (Page 698) 
WarningLow Property (Page 698) 
WarningHigh Property (Page 697) 
Visible Property (Page 696) 
TypeWarningLow Property (Page 671) 
TypeWarningHigh Property (Page 670) 
TypeToleranceLow Property (Page 670) 


no bar" & vbCrLf 
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TypeToleranceHigh Property (Page 670) 
TypeLimitLow5 Property (Page 670) 
TypeLimitLow4 Property (Page 669) 
TypeLimitHigh5 Property (Page 669) 
TypeLimitHigh4 Property (Page 669) 
TypeAlarmLow Property (Page 668) 
TypeAlarmHigh Property (Page 668) 
Type Property (Page 666) 
LTrendColor property (before WinCC V7) (Page 647) 
Trend Property (Page 645) 

Top Property (Page 643) 
ToleranceLow Property (Page 628) 
ToleranceHigh Property (Page 628) 
ScalingType Property (Page 558) 
Scaling Property (Page 558) 
ScaleTicks Property (Page 558) 
ScaleColor Property (Page 558) 
RightComma Property (Page 551) 
Process Property (Page 544) 
PasswordLevel Property (Page 530) 
Parent Property (Page 529) 
ObjectName Property (Page 512) 

Min Property (Page 506) 

Max Property (Page 488) 

Marker Property (Page 488) 
LongStrokesTextEach Property (Page 485) 
LongStrokesSize Property (Page 485) 
LongStrokesOnly Property (Page 485) 
LongStrokesBold Property (Page 484) 
LimitLow5 Property (Page 479) 
LimitLow4 Property (Page 478) 
LimitHigh5 Property (Page 478) 
LimitHigh4 Property (Page 478) 
LeftComma Property (Page 477) 

Left Property (Page 476) 
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HysteresisRange Property (Page 451) 
Hysteresis Property (Page 451) 

Height Property (Page 443) 

FontSize Property (Page 433) 

FontName Property (Page 433) 

FontBold Property (Page 432) 
FlashRateBorderColor Property (Page 427) 
FlashRateBackColor Property (Page 427) 
FlashBorderColor Property (Page 424) 
FlashBackColor Property (Page 423) 
FillStyle2 Property (Page 421) 

FillStyle Property (Page 419) 

FillColor Property (Page 418) 

Exponent Property (Page 412) 

Enabled Property (Page 408) 

Direction Property (Page 405) 
ColorWarningLow Property (Page 378) 
ColorWarningHigh Property (Page 378) 
ColorToleranceLow Property (Page 377) 
ColorToleranceHigh Property (Page 377) 
ColorLimitLow5 Property (Page 377) 
ColorLimitLow4 Property (Page 376) 
ColorLimitHigh5 Property (Page 376) 
ColorLimitHigh4 Property (Page 376) 
ColorAlarmLow Property (Page 375) 
ColorAlarmHigh Property (Page 374) 
CheckWarningLow Property (Page 370) 
CheckWarningHigh Property (Page 369) 
CheckToleranceLow Property (Page 369) 
CheckToleranceHigh Property (Page 369) 
CheckLimitLow5 Property (Page 368) 
CheckLimitLow4 Property (Page 368) 
CheckLimitHigh5 Property (Page 368) 
CheckLimitHigh4 Property (Page 367) 
CheckAlarmLow Property (Page 367) 
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Picture Window 


Description 


7.14 VBS Reference 


CheckAlarmHigh Property (Page 367) 
BorderWidth Property (Page 355) 
BorderStyle Property (Page 355) 
BorderFlashColorOn Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
BorderColor Property (Page 353) 
BorderBackColor Property (Page 353) 
BackFlashColorOn Property (Page 324) 
BackFlashColorOff Property (Page 324) 
BackColor3 Property (Page 323) 
BackColor2 Property (Page 323) 
BackColor Property (Page 322) 
AxisSection Property (Page 321) 
Alignment Property (Page 309) 
AlarmLow Property (Page 309) 
AlarmHigh Property (Page 308) 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Picture Window" 


Type Identifier in VBS 


HMIScreenWindow 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


179 


VBS for Creating Procedures and Actions 


7.14 VBS Reference 


Usage 


"VBS35 


In the following example, the object with the name "ScreenWindow1" is moved 10 pixels to 


the right: 


Dim objScrWindow 


Set objScrWindow = ScreenItems ("ScreenWindowl") 


objScrWindow.Left = objScrWindow.Left + 10 


See also 
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ServerPrefix Property (Page 571) 
Activate Method (Page 712) 
Properties (Page 301) 

Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Zoom Property (Page 709) 
WindowBorder Property (Page 699) 
Width Property (Page 698) 

Visible Property (Page 696) 
UpdateCycle Property (Page 673) 
Type Property (Page 666) 

Top Property (Page 643) 

TagPrefix Property (Page 596) 
ScrollPositionY Property (Page 562) 
ScrollPositionX Property (Page 562) 
ScrollBars Property (Page 561) 
ScreenName Property (Page 560) 
Screens Property (Page 560) 
Parent Property (Page 529) 

OnTop Property (Page 517) 
OffsetTop Property (Page 516) 
OffsetLeft Property (Page 515) 
ObjectName Property (Page 512) 
Moveable Property (Page 507) 
MaximizeButton Property (Page 488) 
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Control 


Description 


7.14 VBS Reference 


Left Property (Page 476) 

Layer Object (Page 120) 

Height Property (Page 443) 

Enabled Property (Page 408) 
CloseButton Property (Page 371) 
CaptionText Property (Page 364) 
Caption Property (Page 362) 

AdaptSize Property (Page 307) 
AdaptPicture Property (Page 307) 
MenuToolBarConfig Property (Page 495) 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Control" 


The Control object type always assumes the properties of the Control type selected. In the 
case of controls provided by WinCC, the properties are indicated under the description of the 
corresponding Control. 


In the case of controls from external suppliers, the control properties are supplied and thus not 
a part of this description. However, the control properties can be queried using the "Item" 
property. 


Type Identifier in VBS 


Special WinCC type descriptions or version-independent ProgID 
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Usage 
In the following example, the object with the name "Control1" is moved 10 pixels to the right: 


"VBS36 
Dim objControl 
Set objControl = ScreenItems ("Controll") 


objControl.Left = objControl.Left + 10 


Special feature 
The controls provided by WinCC return a special ID as the type. It can be found under the 
topic "Type Identification in VBS" in the individual descriptions of the WinCC Controls. 


Use of Controls from External Suppliers 
In the case of non-WinCC controls, the version-independent ProgID is returned as the type. 


It is possible to determine the version-dependent ProgID or "User friendly Name" from the 
ProgID: In the following example, "Control1" is a control embedded in the picture which already 
returns the version-independent ProgID as a result of the Type property. 


Note 

Since not every Control has a version-dependent ProgID, an error handling measure should 
be integrated to query the version-dependent ProgID or UserFriendlyName. If no error handling 
is used, the code is terminated immediately without any result when no ProgID is found. 


Determine the version-dependent ProgID as follows: 


"VBS37 
Dim objControl 
Dim strCurrentVersion 


Set objControl = ScreenItems ("Controll") 
strCurrentVersion = CreateObject ("WScript.Shell") .RegRead("HKCR\" & objControl.Type & 


"\CurVer\") 
MsgBox strCurrentVersion 


Note 
In order that example above works, a multimedia control should be inserted in the picture. 
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Determine the UserFriendlyName as follows: 


"VBS 38 
Dim objControl 


Dim strFriendlyName 


Set objControl = 


ScreenlItems ("Controll") 
strFriendlyName = CreateObject ("WScript.Shell") .RegRead("HKCR\" & objControl.Type & "\") 


MsgBox strFriendlyName 


7.14 VBS Reference 


Note 


In order that example above works, a multimedia control should be inserted in the picture. 


If anon-WinCC control is used, it is possible that the properties provided by the control have 


the same names as the general Screenltem properties. In such cases, the Screenltem 
properties have priority. The "hidden" properties of an external control supplier can be 


accessed using the additional "object" property. Address the properties of an external control 
supplier as follows: 


Control.object.type 


The properties of the Screenltem object are used in the case of identical names, if you use 
the following form: 


Control.type 


WinCC controls available 


WinCC Alarm Control 
WinCC Digital/Analog Clock 
WinCC FunctionTrendControl 
WinCC Gauge Control 
WinCC Media Control 
WinCC OnlineTableControl 
WinCC OnlineTrendControl 
WinCC Push Button Control 
WinCC Slider Control 
WinCC UserArchiveControl 
HMI Symbol Library 
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See also 
Object Property (Page 512) 
Activate Method (Page 712) 
Properties (Page 301) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Width Property (Page 698) 
Visible Property (Page 696) 
Type Property (Page 666) 
Top Property (Page 643) 
Parent Property (Page 529) 
ObjectName Property (Page 512) 
Left Property (Page 476) 
Layer Property (Page 460) 
Height Property (Page 443) 
Enabled Property (Page 408) 


I/O Field 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "I/O Field" 


Type Identifier in VBS 
HMIIOField 
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Usage 


7.14 VBS Reference 


In the following example, the object with the name "IOField1" is moved 10 pixels to the right: 


"VBS39 

Dim objIOField 

Set objIOField = ScreenItems ("IOField1") 
objIOField.Left = objIOField.Left + 10 


See also 
OperationMessage Property (Page 517) 
EditAtOnce Property (Page 407) 
Activate Method (Page 712) 
Properties (Page 301) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Width Property (Page 698) 
Visible Property (Page 696) 
Type Property (Page 666) 
Top Property (Page 643) 
ToolTipText Property (Page 641) 
PasswordLevel Property (Page 530) 
Parent Property (Page 529) 
OutputValue Property (Page 528) 
OutputFormat Property (Page 527) 
Orientation Property (Page 526) 
OperationReport Property (Page 525) 
ObjectName Property (Page 512) 
LimitMin Property (Page 479) 
LimitWax Property (Page 479) 
Left Property (Page 476) 
Layer Object (Page 120) 
HiddenInput Property (Page 444) 
Height Property (Page 443) 
ForeFlashColorOn Property (Page 436) 
ForeFlashColorOff Property (Page 435) 
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ForeColor Property (Page 435) 
FontUnderline Property (Page 434) 
FontSize Property (Page 433) 

FontName Property (Page 433) 

Fontltalic Property (Page 432) 

FontBold Property (Page 432) 
FlashRateForeColor Property (Page 428) 
FlashRateBorderColor Property (Page 427) 
FlashRateBackColor Property (Page 427) 
FlashForeColor Property (Page 424) 
FlashBorderColor Property (Page 424) 
FlashBackColor Property (Page 423) 
FillStyle Property (Page 419) 

FillColor Property (Page 418) 

Enabled Property (Page 408) 
DataFormat Property (Page 397) 
CursorControl Property (Page 395) 
ClearOnNew Property (Page 370) 
ClearOnError Property (Page 370) 
BoxType Property (Page 357) 
BorderWidth Property (Page 355) 
BorderStyle Property (Page 355) 
BorderFlashColorOn Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
BorderColor Property (Page 353) 
BorderBackColor Property (Page 353) 
BackFlashColorOn Property (Page 324) 
BackFlashColorOff Property (Page 324) 
BackColor Property (Page 322) 
AssumeOnFull Property (Page 315) 
AssumeOnExit Property (Page 315) 
AlignmentTop Property (Page 310) 
AlignmentLeft Property (Page 309) 
AdaptBorder Property (Page 306) 
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Faceplate Instance 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the "faceplate instance" graphic object. 


Type identifier in VBS 
HMIFaceplateObject 


Usage 


In the following example, the object with the name "Faceplatelnstance1" is moved 10 pixels 
to the right: 


"VBS309 

Dim objFaceplateObject 

Set objFaceplateObject = ScreenItems ("FaceplateInstancel") 
objFaceplateObject.Left = objFaceplateObject.Left + 10 


Graphic Object 


Description 


Screens 


Screen 


Screenltems 


Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Graphic Object" 
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Type Identifier in VBS 
HMIGraphicView 


Usage 


In the following example, the object with the name "GraphicObject1" is moved 10 pixels to the 
right: 


'VBS40 

Dim objGraphicView 

Set objGraphicView= ScreenItems ("GraphicObject1") 
objGraphicView.Left = objGraphicView.Left + 10 


See also 
Parent Property (Page 529) 
Activate Method (Page 712) 
Properties (Page 301) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Width Property (Page 698) 
Visible Property (Page 696) 
Type Property (Page 666) 
Top Property (Page 643) 
ToolTipText Property (Page 641) 
PicUseTransColor Property (Page 540) 
PictureName Property (Page 538) 
PicTransColor Property (Page 536) 
PicReferenced Property (Page 535) 
PasswordLevel Property (Page 530) 
ObjectName Property (Page 512) 
Left Property (Page 476) 
Layer Object (Page 120) 
Height Property (Page 443) 
FlashRateBorderColor Property (Page 427) 
FlashRateBackColor Property (Page 427) 
FlashBorderColor Property (Page 424) 
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FlashBackColor Property (Page 423) 
FillStyle Property (Page 419) 

Fillinglndex Property (Page 419) 

Filling Property (Page 419) 

FillColor Property (Page 418) 

Enabled Property (Page 408) 
BorderWidth Property (Page 355) 
BorderStyle Property (Page 355) 
BorderFlashColorOn Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
BorderColor Property (Page 353) 
BorderBackColor Property (Page 353) 
BackFlashColorOn Property (Page 324) 
BackFlashColorOff Property (Page 324) 
BackColor Property (Page 322) 


Combobox 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the "Combobox" graphic object. 


Type Identifier in VBS 
HMIComboBox 
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Usage 
In the following example, the object with the name "ComboBox1" is moved 10 pixels to the 
right: 


"VBS21 

Dim objComboBox 

Set objComboBox = ScreenItems ("ComboBox1") 
objComboBox.Left = objComboBox.Left + 10 


List Box 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the "List Box" graphic object. 


Type Identifier in VBS 
HMIListBox 


Usage 
In the following example, the object with the name "ListBox1" is moved 10 pixels to the right: 


'VBS21 

Dim objListBox 

Set objListBox = ScreenItems ("ListBox1") 
objListBox.Left = objListBox.Left + 10 
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Multiple row text 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the "Multiline Text" graphic object. 


Type Identifier in VBS 
HMIMultiLineEdit 


Usage 


In the following example, the object with the name "MultiLineEdit1" is moved 10 pixels to the 
right: 


"'VBS21 

Dim objMultiLineEdit 

Set objMultiLineEdit = ScreenItems ("MultiLineEdit1") 
objMultiLineEdit.Left = objMultiLineEdit.Left + 10 


OLE object 


Description 


Screens 


Screen 


Screenltems 


Screenltem 


Object Type of Screenltem Object. Represents the graphic object "OLE Element". The return 
value is a STRING type. 
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Type Identifier in VBS 
Version-independent ProgID 


Usage 
In the following example, the object with the name "OLEElement1" is moved 10 pixels to the 
right: 


"VBS41 

Dim objJOLEElLement 

Set objJOLEElement = ScreenItems ("OLEElement1") 
objOLEElement.Left = objOLEElement.Left + 10 


Special feature 
In the case of OLE Elements, the version-independent ProgID is returned as the type. 
It is possible to determine the version-dependent ProgID or "User friendly Name" from the 


ProgID: In the following example, "OLEObject1" is a control embedded in the picture which 
already returns the version-independent ProgID as a result of the Type property. 


Note 

Since not every Control has a version-dependent ProgID, an error handling measure should 
be integrated to query the version-dependent ProgID or UserFriendlyName. If no error handling 
is used, the code is terminated immediately without any result when no ProgID is found. 


Determine the version-dependent ProgID as follows: 


"VBS42 

Dim objControl 

Dim strCurrentVersion 

Set objControl = ScreenItems ("OLEElement1") 

strCurrentVersion = CreateObject ("WScript.Shell") .RegRead("HKCR\" & objControl.Type & 


"\CurVer\") 
MsgBox strCurrentVersion 


Note 
In order that the example above works, a Word document should be embedded in the picture 
as an OLE Element. 
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Determine the User Friendly Name as follows: 


"VBS43 

Dim objControl 

Dim strFriendlyName 

Set objControl = ScreenItems ("OLEElement1") 

strFriendlyName = CreateObject ("WScript.Shell") .RegRead("HKCR\" & objControl.Type & "\") 


MsgBox strFriendlyName 


Note 


In order that the example above works, a Word document should be embedded in the picture 
as an OLE Element. 


Using OLE Elements 


If an OLE Element is used, it is possible that the properties provided by the OLE Element have 
the same names as the general Screenltem properties. In such cases, the Screenltem 
properties have priority. The "hidden" properties of an OLE Element can be accessed using 
the additional "Object" property. Address the properties of an OLE Element as follows: 


OLEObjJekt.object.typ 


Only use the form 


OLEObJekt.type 


In the case of identical names, the properties of the Screenltem object are used. 


See also 
Height Property (Page 443) 
Activate Method (Page 712) 
Properties (Page 301) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Width Property (Page 698) 
Visible Property (Page 696) 
Type Property (Page 666) 
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Top Property (Page 643) 
ToolTipText Property (Page 641) 
Parent Property (Page 529) 
Object Property (Page 512) 
ObjectName Property (Page 512) 
Left Property (Page 476) 

Layer Property (Page 460) 
Enabled Property (Page 408) 


Group Display 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Group Display" 


Type Identifier in VBS 
HM IGroupDisplay 


Usage 


In the following example, the object with the name "GroupDisplay1" is moved 10 pixels to the 
right: 


"VBS44 

Dim objGroupDisplay 

Set objGroupDisplay = ScreenItems ("GroupDisplayl") 
objGroupDisplay.Left = objGroupDisplay.Left + 10 


See also 
Activate Method (Page 712) 
MCKQBackColorOn Property (Page 492) 
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FontBold Property (Page 432) 
Properties (Page 301) 

Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 

Width Property (Page 698) 

Visible Property (Page 696) 

UserValue4 Property (Page 678) 
UserValue3 Property (Page 677) 
UserValue2-Eigenschaft (Page 677) 
UserValue1 Property (Page 677) 

Type Property (Page 666) 

Top Property (Page 643) 

ToolTipText Property (Page 641) 
SignificantMask Property (Page 579) 
SameSize Property (Page 557) 
Relevant Property (Page 550) 
PasswordLevel Property (Page 530) 
Parent Property (Page 529) 
ObjectName Property (Page 512) 
MessageClass Property (Page 503) 
MCText Property (Page 494) 
MCKQTextFlash Property (Page 494) 
MCKQTextColorOn Property (Page 493) 
MCKQTextColorOff Property (Page 493) 
MCKQBackFlash Property (Page 493) 
MCKQBackColorOff Property (Page 492) 
MCKOTextFlash Property (Page 492) 
MCKOTextColorOn Property (Page 492) 
MCKOTextColorOff Property (Page 491) 
MCKOBackFlash Property (Page 491) 
MCKOBackColorOn Property (Page 491) 
MCKOBackColorOff Property (Page 490) 
MCGUTextFlash Property (Page 490) 
MCGUTextColorOn Property (Page 490) 
MCGUTextColorOff Property (Page 490) 
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Text list 


Description 
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MCGUBackFlash Property (Page 489) 
MCGUBackColorOn Property (Page 489) 
MCGUBackColorOff-Eigenschaft (Page 489) 
LockTextColor Property (Page 484) 
LockText Property (Page 484) 

LockStatus Property (Page 483) 
LockBackColor Property (Page 483) 

Left Property (Page 476) 

Layer Object (Page 120) 

Height Property (Page 443) 

FontUnderline Property (Page 434) 

FontSize Property (Page 433) 
FontName Property (Page 433) 
Fontltalic Property (Page 432) 
FlashRate Property (Page 426) 
Enabled Property (Page 408) 
CollectValue Property (Page 373) 
Button4Width Property (Page 362 
Button3Width Property (Page 362 
Button2Width Property (Page 361 
Button1 Width Property (Page 361 
BackColor Property (Page 322) 
AlignmentTop Property (Page 310) 
AlignmentLeft Property (Page 309) 


) 
) 
) 
) 


Screens 
Screen 


Screenltems 
Screenltem 
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Object Type of Screenltem Object. Represents the graphic object "Text List" 


Type Identifier in VBS 
HMISymboliclOField 


Usage 
In the following example, the object with the name "TextList1" is moved 10 pixels to the right: 


"VBS45 

Dim objSymIO 

Set objSymIO = ScreenItems ("TextList1") 
objSymIO.Left = objSymIO.Left + 10 


See also 
Type Property (Page 666) 
FontUnderline Property (Page 434) 
BackFlashColorOff Property (Page 324) 
Activate Method (Page 712) 
Properties (Page 301) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Width Property (Page 698) 
Visible Property (Page 696) 
UnselTextColor Property (Page 673) 
UnselBGColor Property (Page 672) 
Top Property (Page 643) 
ToolTipText Property (Page 641) 
SelTextColor Property (Page 569) 
SelBGColor Property (Page 563) 
PasswordLevel Property (Page 530) 
Parent Property (Page 529) 
OutputValue Property (Page 528) 
Orientation Property (Page 526) 
OperationReport Property (Page 525) 
OperationMessage Property (Page 517) 
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ObjectName Property (Page 512) 
NumberLines Property (Page 511) 
ListType Property (Page 481) 

Left Property (Page 476) 

Layer Object (Page 120) 
LanguageSwitch Property (Page 458) 
ItemBorderWidth Property (Page 456) 
ItemBorderStyle Property (Page 455) 
ItemBorderColor Property (Page 455) 
ItemBorderBackColor Property (Page 455) 
Height Property (Page 443) 
ForeFlashColorOn Property (Page 436) 
ForeFlashColorOff Property (Page 435) 
ForeColor Property (Page 435) 

FontSize Property (Page 433) 

FontName Property (Page 433) 

Fontltalic Property (Page 432) 

FontBold Property (Page 432) 
FlashRateForeColor Property (Page 428) 
FlashRateBorderColor Property (Page 427) 
FlashRateBackColor Property (Page 427) 
FlashForeColor Property (Page 424) 
FlashBorderColor Property (Page 424) 
FlashBackColor Property (Page 423) 
FillStyle Property (Page 419) 

FillColor Property (Page 418) 

Enabled Property (Page 408) 

EditAtOnce Property (Page 407) 
CursorControl Property (Page 395) 
BoxType Property (Page 357) 
BorderWidth Property (Page 355) 
BorderStyle Property (Page 355) 
BorderFlashColorOn Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
BorderColor Property (Page 353) 
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BorderBackColor Property (Page 353) 
BitNumber Property (Page 346) 
BackFlashColorOn Property (Page 324) 
BackColor Property (Page 322) 
AssumeOnExit Property (Page 315) 
Assignments Property (Page 315) 
AlignmentTop Property (Page 310) 
AlignmentLeft Property (Page 309) 
AdaptBorder Property (Page 306) 


Status display 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Status Display" 


Type Identifier in VBS 
HMIGraphiclOField 


Usage 


In the following example, the object with the name "StatusDisplay1" is moved 10 pixels to the 
right: 


"VBS46 

Dim objGraphicIoO 

Set objGraphicIO= ScreenItems ("StatusDisplayl") 
objGraphicIO.Left = objGraphicIO.Left + 10 
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See also 
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Layer Object (Page 120) 

Activate Method (Page 712) 

Properties (Page 301) 

Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 

Width Property (Page 698) 

Visible Property (Page 696) 

Type Property (Page 666) 

Top Property (Page 643) 

ToolTipText Property (Page 641) 
PasswordLevel Property (Page 530) 
Parent Property (Page 529) 

ObjectName Property (Page 512) 

Left Property (Page 476) 

Index Property (Page 452) 

Height Property (Page 443) 
FlashRateFlashPic Property (Page 428) 
FlashRateBorderColor Property (Page 427) 
FlashPicUseTransColor Property (Page 426) 
FlashPicture Property (Page 425) 
FlashPicTransColor Property (Page 425) 
FlashPicReferenced Property (Page 425) 
FlashFlashPicture Property (Page 424) 
FlashBorderColor Property (Page 424) 
Enabled Property (Page 408) 
BorderWidth Property (Page 355) 
BorderStyle Property (Page 355) 
BorderFlashColorOn Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
BorderColor Property (Page 353) 
BorderBackColor Property (Page 353) 
BasePicUseTransColor Property (Page 341) 
BasePicture Property (Page 341) 
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BasePicTransColor Property (Page 341) 
BasePicReferenced Property (Page 340) 


1.14.3.4 Windows objects 


Button 


Description 


Screens 


Screen 


Screenltems 


Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Button" 


Type Identifier in VBS 
HM|Button 


Usage 
In the following example, the object with the name "Button1" is moved 10 pixels to the right: 


"VBS47 


Dim cmdButton 
ScreenItems ("Buttonl1") 


Set cmdButton = 
emdButton.Left = cmdButton.Left + 10 


Notes on Error Handling 
Buttons and pushbuttons are mapped in the object model to an "HMIButton" type. Since the 


objects have different properties, the availability of the property (dynamic type compilation in 
Runtime) should be queried via an exception measure. The exception measure is activated 


for the corresponding procedure by the following instruction: 


On Error Resume Next 
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The instruction causes the VBScript engine to initiate the follow-on command in the case of a 
Runtime error. 


The error code can subsequently be checked using the Err object. In order to deactivate the 
handling of Runtime errors in scripts, use the following command: 


On Error Goto 0 


Handling errors always relates to the procedure layer. If a script in a procedure causes an 
error, VBScript checks whether an error handling measure is implemented in this layer. If not, 
control is transferred one layer up (to the calling procedure). If there is no error handling 
measure here either, the control is transferred yet another layer up. This continues until either 
the top module level is reached or the code for Runtime error handling is located. If the 
activation of the Runtime error handling fails, the control is transferred to the top level on the 
internal VBScript Runtime error handing. This opens an error dialog and stops the script. 


The "On Error Resume Next" command can be installed on all layers (i.e. also in procedures). 
When the error handling measure is use, it can basically be determined whether the user is 
actually using the required implementation type. 


In addition, it can be ensured that there is no termination of execution due to a faulty access 
to the object. 


Examples of error handling 


Sub OnClick(ByVal Item) 


"VBS 48 

Dim objScreenItem 

On Error Resume Next "Activation of errorhandling 
For Each objScreenItem In ScreenItems 

If objScreenItem.Type = "HMIButton" Then 


‘=== Property "Text" available only for Standard-Button 


objScreenItem.Text = "Windows" 

If 0 <> Err.Number Then 

HMTRuntime.Trace objScreenItem.ObjectName & ": no Windows-Button" & vbCrLf 
Err.Clear "Delet rror messag 

End If 

End If 

Next 

On Error Goto 0 "Deactivation of errorhandling 

End Sub 

See also 


Top Property (Page 643) 
FlashBorderColor Property (Page 424) 
Activate Method (Page 712) 
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Properties (Page 301) 

Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
WindowsStyle Property (Page 700) 
Width Property (Page 698) 

Visible Property (Page 696) 

Type Property (Page 666) 

ToolTipText Property (Page 641) 

Text list (Page 196) 

PictureUp Property (Page 539) 
PictureDown Property (Page 537) 
PasswordLevel Property (Page 530) 
Parent Property (Page 529) 

Orientation Property (Page 526) 
ObjectName Property (Page 512) 

Left Property (Page 476) 

Layer Object (Page 120) 

Hotkey Property (Page 450) 

Height Property (Page 443) 
ForeFlashColorOn Property (Page 436) 
ForeFlashColorOff Property (Page 435) 
ForeColor Property (Page 435) 
FontUnderline Property (Page 434) 
FontSize Property (Page 433) 
FontName Property (Page 433) 
Fontltalic Property (Page 432) 
FontBold Property (Page 432) 
FlashRateForeColor Property (Page 428) 
FlashRateBorderColor Property (Page 427) 
FlashRateBackColor Property (Page 427) 
FlashForeColor Property (Page 424) 
FlashBackColor Property (Page 423) 
FillStyle Property (Page 419) 
Fillinglndex Property (Page 419) 

Filling Property (Page 419) 
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FillColor Property (Page 418) 

Enabled Property (Page 408) 
BorderWidth Property (Page 355) 
BorderStyle Property (Page 355) 
BorderFlashColorOn Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
BorderColorTop Property (Page 354) 
BorderColor Property (Page 353) 
BorderColorBottom Property (Page 354) 
BorderBackColor Property (Page 353) 
BackFlashColorOn Property (Page 324) 
BackFlashColorOff Property (Page 324) 
BackColor Property (Page 322) 
AlignmentTop Property (Page 310) 
AlignmentLeft Property (Page 309) 
AdaptBorder Property (Page 306) 


Check box 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Check Box" 


Type Identifier in VBS 
HMICheckBox 
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In the following example, the object with the name "CheckBox1" is moved 10 pixels to the right: 


"VBS49 

Dim chkCheckBox 

Set chkCheckBox = ScreenItems ("CheckBox1") 
chkCheckBox.Left = chkCheckBox.Left + 10 


See also 
FontSize Property (Page 433) 
BackColor Property (Page 322) 
Activate Method (Page 712) 
Properties (Page 301) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Width Property (Page 698) 
Visible Property (Page 696) 
Type Property (Page 666) 
Top Property (Page 643) 
ToolTipText Property (Page 641) 
Text list (Page 196) 
Process Property (Page 544) 
PasswordLevel Property (Page 530) 
Parent Property (Page 529) 
Orientation Property (Page 526) 
OperationMessage Property (Page 517) 
ObjectName Property (Page 512) 
Left Property (Page 476) 
Layer Object (Page 120) 
Index Property (Page 452) 
Height Property (Page 443) 
ForeFlashColorOn Property (Page 436) 
ForeFlashColorOff Property (Page 435) 
ForeColor Property (Page 435) 
FontUnderline Property (Page 434) 
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FontName Property (Page 433) 

Fontltalic Property (Page 432) 

FontBold Property (Page 432) 
FlashRateForeColor Property (Page 428) 
FlashRateBorderColor Property (Page 427) 
FlashRateBackColor Property (Page 427) 
FlashForeColor Property (Page 424) 
FlashBorderColor Property (Page 424) 
FlashBackColor Property (Page 423) 
FillStyle Property (Page 419) 

Fillinglndex Property (Page 419) 

Filling Property (Page 419) 

FillColor Property (Page 418) 

Enabled Property (Page 408) 

BoxCount Property (Page 357) 
BoxAlignment Property (Page 356) 
BorderWidth Property (Page 355) 
BorderStyle Property (Page 355) 
BorderFlashColorOn Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
BorderColor Property (Page 353) 
BorderBackColor Property (Page 353) 
BackFlashColorOn Property (Page 324) 
BackFlashColorOff Property (Page 324) 
AlignmentTop Property (Page 310) 
AlignmentLeft Property (Page 309) 
AdaptBorder Property (Page 306) 
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Radio box 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Radio Box" 


Type Identifier in VBS 


Usage 


"VBS50 


HMI|OptionGroup 


7.14 VBS Reference 


In the following example, the object with the name "RadioBox1" is moved 10 pixels to the right: 


Dim objOptionGroup 
Set objOptionGroup = ScreenItems ("RadioBox1") 
objOptionGroup.Left = objOptionGroup.Left + 10 


See also 


ForeColor Property (Page 435) 
BackFlashColorOn Property (Page 324) 
Activate Method (Page 712) 
Properties (Page 301) 

Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 

Width Property (Page 698) 

Visible Property (Page 696) 

Type Property (Page 666) 

Top Property (Page 643) 
ToolTipText Property (Page 641) 
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Text list (Page 196) 

Process Property (Page 544) 
PasswordLevel Property (Page 530) 
Parent Property (Page 529) 

Orientation Property (Page 526) 
OperationMessage Property (Page 517) 
ObjectName Property (Page 512) 

Left Property (Page 476) 

Layer Object (Page 120) 

Index Property (Page 452) 

Height Property (Page 443) 
ForeFlashColorOn Property (Page 436) 
ForeFlashColorOff Property (Page 435) 
FontUnderline Property (Page 434) 
FontSize Property (Page 433) 

FontName Property (Page 433) 

Fontltalic Property (Page 432) 

FontBold Property (Page 432) 
FlashRateForeColor Property (Page 428) 
FlashRateBorderColor Property (Page 427) 
FlashRateBackColor Property (Page 427) 
FlashForeColor Property (Page 424) 
FlashBorderColor Property (Page 424) 
FlashBackColor Property (Page 423) 
FillStyle Property (Page 419) 

Fillinglndex Property (Page 419) 

Filling Property (Page 419) 

FillColor Property (Page 418) 

Enabled Property (Page 408) 

BoxCount Property (Page 357) 
BoxAlignment Property (Page 356) 
BorderWidth Property (Page 355) 
BorderStyle Property (Page 355) 
BorderFlashColorOn Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
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BorderColor Property (Page 353) 
BorderBackColor Property (Page 353) 
BackFlashColorOff Property (Page 324) 
BackColor Property (Page 322) 
AlignmentTop Property (Page 310) 
AlignmentLeft Property (Page 309) 
AdaptBorder Property (Page 306) 


Round Button 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Round Button" 


Type Identifier in VBS 


HMISwitch 
Usage 
In the following example, the object with the name "RoundButton1" is moved 10 pixels to the 
right: 
'VBS51 


Dim objSwitch 
Set objSwitch= ScreenItems ("RoundButton1") 
objSwitch.Left = objSwitch.Left + 10 
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Sub OnClick(ByVal Item) 
"VBS52 
Dim objScreenItem 


On Error Resume Next "Activation of errorhandling 
For Each objScreenItem In ScreenItems 
If objScreenItem.Type = "HMIButton" Then 


‘=== Property "Text" available only for Standard-Button 

objScreenItem.Text = "Windows" 

If 0 <> Err.Number Then 

HMTRuntime.Trace objScreenItem.ObjectName & ": no Windows-Button" & vbCrhf 
Err.Clear "Delet rror messag 

End If 


‘=== Property "Radius" available only for RoundButton 


objScreenItem.Radius = 10 
If 0 <> Err.Number Then 
HMTRuntime.Trace ScreenItem.ObjectName & ": no RoundButton" & vbCrLf 
Err.Clear 
End If 
End If 
ext 

On Error Goto 0 "Deactivation of errorhandling 

End Sub 

See also 


PicDownUseTransColor Property (Page 535) 
BorderColorTop Property (Page 354) 
Activate Method (Page 712) 

Properties (Page 301) 

Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 

Width Property (Page 698) 

Visible Property (Page 696) 

Type Property (Page 666) 

Top Property (Page 643) 

ToolTipText Property (Page 641) 

Toggle Property (Page 627) 

Radius Property (Page 547) 

Pressed Property (Page 543) 
PicUpUseTransColor Property (Page 540) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
210 System Manual, 02/2016, ASE37536061-AA 


VBS for Creating Procedures and Actions 
7.14 VBS Reference 


PicUpTransparent Property (Page 540) 
PicUpReferenced Property (Page 539) 
PictureUp Property (Page 539) 
PictureDown Property (Page 537) 
PictureDeactivated Property (Page 537) 
PicDownTransparent Property (Page 535) 
PicDownReferenced Property (Page 535) 
PicDeactUseTransColor Property (Page 534) 
PicDeactTransparent Property (Page 534) 
PicDeactReferenced-Eigenschaft (Page 534) 
PasswordLevel Property (Page 530) 
Parent Property (Page 529) 

ObjectName Property (Page 512) 

Left Property (Page 476) 

Layer Object (Page 120) 

Height Property (Page 443) 
FlashRateBorderColor Property (Page 427) 
FlashRateBackColor Property (Page 427) 
FlashBorderColor Property (Page 424) 
FlashBackColor Property (Page 423) 
FillStyle Property (Page 419) 

Fillinglndex Property (Page 419) 

Filling Property (Page 419) 

FillColor Property (Page 418) 

Enabled Property (Page 408) 
BorderWidth Property (Page 355) 
BorderStyle Property (Page 355) 
BorderFlashColorOn Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
BorderColor Property (Page 353) 
BorderColorBottom Property (Page 354) 
BorderBackColor Property (Page 353) 
BackFlashColorOn Property (Page 324) 
BackFlashColorOff Property (Page 324) 
BackColor Property (Page 322) 
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Slider 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Slider" 


Type Identifier in VBS 
HMISlider 


Usage 
In the following example, the object with the name "Slider1" is moved 10 pixels to the right: 


"VBS53 

Dim sldSlider 

Set sldSlider = ScreenItems ("Sliderl") 
sldSlider.Left = sldSlider.Left + 10 


Notes on Error Handling 


Sliders and WinCC slider controls are mapped in the object model to an "HMISlider" type. 
Since the objects have different properties, the availability of the property (dynamic type 
compilation in Runtime) should be queried via an exception measure. The exception measure 
is activated for the corresponding procedure by the following instruction: 


On Error Resume Next 


The instruction causes the VBScript engine to initiate the follow-on command in the case of a 
Runtime error. 


The error code can subsequently be checked using the Err object. In order to deactivate the 
handling of Runtime errors in scripts, use the following command: 


On Error Goto 0 
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Handling errors always relates to the procedure layer. If a script in a procedure causes an 
error, VBScript checks whether an error handling measure is implemented in this layer. If not, 
control is transferred one layer up (to the calling procedure). If there is no error handling 
measure here either, the control is transferred yet another layer up. This continues until either 
the top module level is reached or the code for Runtime error handling is located. If the 
activation of the Runtime error handling fails, the control is transferred to the top level on the 
internal VBScript Runtime error handing. This opens an error dialog and stops the script. 


The "On Error Resume Next" command can be installed on all layers (i.e. also in procedures). 
When the error handling measure is use, it can basically be determined whether the user is 
actually using the required implementation type. 


In addition, it can be ensured that there is no termination of execution due to a faulty access 
to the object. 


Examples of error handling 


Sub OnClick(Byval Item) 

'VBS194 

Dim ScreenItem 

" activating error handling: 

On Error Resume Next 

For Each ScreenItem In ScreenItems 


If ScreenItem.Type = "HMISlider" Then 
‘=== Property "BevelColorUp" only exists for a WinCC Slider Control 
ScreenItem.BevelColorUp = 1 
If (Err.Number <> 0) Then 
HMTRuntime.Trace (ScreenItem.ObjectName + ": no Windows-Slider" + vbCrlf) 
" delet rror messag 
Err.Clear 
End If 
‘=== Property "BorderStyle" only exists for a Windows-Slider 
ScreenItem.BorderStyle = 1 
If (Err.Number <> 0) Then 
HMTRuntime.Trace (ScreenItem.ObjectName + ": no WinCC Slider Control" + vbCrlf) 
Err.Clear 
End If 
End If 
ext 
On Error GoTo 0 ' deactivating error handling 
End Sub 
See also 


Height Property (Page 443) 
BackColorBottom Property (Page 323) 
Activate Method (Page 712) 
Properties (Page 301) 
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Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
WindowsStyle Property (Page 700) 
Width Property (Page 698) 

Visible Property (Page 696) 

Type Property (Page 666) 

Top Property (Page 643) 

ToolTipText Property (Page 641) 
SmallChange Property (Page 580) 
Process Property (Page 544) 
PasswordLevel Property (Page 530) 
Parent Property (Page 529) 
OperationReport Property (Page 525) 
OperationMessage Property (Page 517) 
ObjectName Property (Page 512) 

Min Property (Page 506) 

Max Property (Page 488) 

Left Property (Page 476) 

Layer Object (Page 120) 
FlashRateBorderColor Property (Page 427) 
FlashRateBackColor Property (Page 427) 
FlashBorderColor Property (Page 424) 
FlashBackColor Property (Page 423) 
FillStyle Property (Page 419) 
Fillinglndex Property (Page 419) 

Filling Property (Page 419) 

FillColor Property (Page 418) 
ExtendedOperation Property (Page 415) 
Enabled Property (Page 408) 

Direction Property (Page 405) 

ColorTop Property (Page 377) 
ColorBottom Property (Page 375) 
ButtonColor Property (Page 357) 
BorderWidth Property (Page 355) 
BorderStyle Property (Page 355) 
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BorderFlashColorOn Property (Page 355) 
BorderFlashColorOff Property (Page 354) 
BorderColor Property (Page 353) 
BorderBackColor Property (Page 353) 
BackFlashColorOn Property (Page 324) 
BackFlashColorOff Property (Page 324) 
BackColorTop Property (Page 323) 
BackColor Property (Page 322) 


1.14.3.5 Tube objects 


Polygon Tube 


Description 


Screens 


Screenltems 


Screenltem 


Object Type of Screenltem Object. Represents the "Polygon Tube" graphic object. 


Type Identifier in VBS 
HMITubePolyline 


Usage 


In the following example, the object with the name "TubePolyline1" is moved 10 pixels to the 
right: 


"VBS24 

Dim objTubePolyline 

Set objTubePolyline = ScreenItems ("TubePolylinel") 
objTubePolyline.Left = objTubePolyline.Left + 10 
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T-piece 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the "T-piece" graphic object. 


Type Identifier in VBS 
HMITubeT eeObject 


Usage 
In the following example, the object with the name "TubeTeeObjecti" is moved 10 pixels to 
the right: 
'VBS21 
Dim objTubeTeeObject 
Set objTubeTeeObject = ScreenlItems ("TubeTeeObject1") 
objTubeTeeObject.Left = objTubeTeeObject.Left + 10 
Double T-piece 
Description 
Screens 


Screen 


Screenltems 


Screenltem 


Object Type of Screenltem Object. Represents the "Double T-piece" graphic object. 
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Type Identifier in VBS 
HM ITubeDoubleTeeObject 


Usage 
In the following example, the object with the name "TubeDoubleTeeObject1" is moved 10 
pixels to the right: 


"VBS21 

Dim objTubeDoubleTeeObject 

Set objTubeDoubleTeeObject = ScreenItems ("TubeDoubleTeeObject1") 
obj TubeDoubleTeeObject.Left = objTubeDoubleTeeObject.Left + 10 


Tube Bend 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the "Tube Arc" graphic object. 


Type Identifier in VBS 
HMITubeArcObject 


Usage 
In the following example, the object with the name "TubeArcObjecti" is moved 10 pixels to the 
right: 


"VBS24 

Dim objTubeArcObject 

Set objTubeArcObject = ScreenItems ("TubeArcObject1") 
objTubeArcObject.Left = objTubeArcObject.Left + 10 
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1.14.3.6 Controls 


Controls 


Special features with controls 
In the case of non-WinCC controls, the version-independent ProgID is returned as the type. 
It is possible to determine the version-dependent ProgID or "User friendly Name" from the 


ProgID: In the following example, "Control1" is a control embedded in the picture which already 
returns the version-independent ProgID as a result of the Type property. 


Note 

Since not every Control has a version-dependent ProgID, an error handling measure should 
be integrated to query the version-dependent ProgID or UserFriendlyName. If no error handling 
is used, the code is terminated immediately without any result when no ProgID is found. 


Determine the version-dependent ProgID as follows: 


'VBS153 

Dim objControl 

Dim strCurrentVersion 

Set objControl = ScreenItems ("Controll") 

strCurrentVersion = CreateObject ("WScript.Shell") .RegRead("HKCR\" & objControl.Type & 
"\CurVer\") 

MsgBox strCurrentVersion 


Note 
In order that example above works, a multimedia control should be inserted in the picture. 


Determine the User Friendly Name as follows: 


"VBS154 

Dim objControl 

Dim strFriendlyName 

Set objControl = ScreenItems ("Controll") 

= CreateObject ("WScript.Shell") .RegRead("HKCR\" & objControl.Type & "\") 


strFriendlyNam 
MsgBox strFriendlyName 


Note 
In order that example above works, a multimedia control should be inserted in the picture. 
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Restrictions of VBS for Dynamization by Controls 
If Controls are to be dynamized with, the following conditions must be fulfilled: 


Methods 
The "ByRef" declaration may only be implemented as a "Variant" (ByRef xxx as Variant) 


The "ByVal" declaration may only be implemented with tag types (ByVal xxx as Long) 


Properties 
The "ByRef" declaration may only be implemented as a "Variant" (ByRef xxx as Variant) 


The "ByVal" declaration may only be implemented with tag types (ByVal xxx as Long) 


Events 
The "ByRef" declaration is not permitted. 


The "ByVal" declaration may only be implemented as a "Variant" (ByVal xxx as Variant) 


Arrays 
If arrays are used, they must be declared with (ByRef xxx As Variant). 


In order that arrays can be transferred in variants, variant tag must also be inserted as an 
intermediate tag according to the following scheme: 


"VBS151 

Dim arrayPoints (200) 

Dim vArrayCoercion "Variant for array Coercion 

' Make the VBS Array compatibile with the OLE Automation 

vArrayCoercion = (arrayPoints) 

objTrendControl.DataXY = vArrayCoercion ' this array will occur in the control 


Use of Controls from External Suppliers 


If anon-WinCC control is used, it is possible that the properties provided by the control have 
the same names as the general Screenltem properties. In such cases, the Screenltem 
properties have priority. The "hidden" properties of an external control supplier can be 
accessed using the additional "object" property. Address the properties of an external control 
supplier as follows: 


Control.object.type 


If you use the following form, the properties of the Screenltem object are used in the case of 
identical names: 


Control.type 
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Double parameter 


When using a Control which is not an internal WinCC control, it is possible that the event 
prototypes contain a parameter with the name "Item". In this case, the name of the parameter 
is renamed according to "Objectltem" in the VBS prototype submitted. If this name already 
exists, the name is differentiated by numbers being appended. 


WinCC controls available 


See also 
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e HMI Symbol Library 

e WinCC AlarmControl 

@ WinCC Alarm Control (before WinCC V7) 

e WinCC Digital/Analog Clock 

e WinCC FunctionTrendControl 

e WinCC Function Trend Control (before WinCC V7) 
@ WinCC Gauge Control 

e WinCC Media Control 

e WinCC OnlineTableControl 

e WinCC Online Table Control (before WinCC V7) 
e WinCC OnlineTrendControl 

e WinCC Online Trend Control (before WinCC V7) 
e WinCC Push Button Control 

e WinCC RulerControl 

e WinCC Slider Control 

e WinCC UserArchiveControl 


HMI Symbol Library (Page 239) 

WinCC Slider Control (Page 277) 

WinCC Push Button Control (Page 269) 

WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Gauge Control (Page 254) 

WinCC Function Trend Control (before WinCC V7) (Page 288) 
WinCC Digital/Analog Clock (Page 246) 

WinCC Alarm Control (before WinCC V7) (Page 286) 
WinCC UserArchiveControl (Page 280) 

WinCC RulerControl (Page 272) 
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WinCC OnlineTrendControl (Page 262) 
WinCC OnlineTableControl (Page 257) 
WinCC FunctionTrendControl (Page 248) 
WinCC AlarmControl (Page 241) 


List of controls 


Column object (list) 


Description 


7.14 VBS Reference 


The listing of controls is a data container that can save a number of objects of the same type 
(users can change the number). 


Use the "Column" listing object to configure the properties of the columns in the WinCC 
UserArchiveControl. 


Use in the controls 


@ WinCC UserArchiveControl (Page 280) 


Available properties of the object 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. For example, when using "colobj.ColumnName", the listing name "Column" is dropped: 
"colobj.Name". 


ColumnAlias (Page 379) 


ColumnFlagUnique 
(Page 381) 


ColumnPosition (Page 384) 


ColumnSort (Page 387) 


ColumnAlign (Page 379) 


ColumnHideText (Page 381) 


ColumnPrecisions 


ColumnSortIndex (Page 387) 


(Page 384) 
ColumnAutoPrecisions ColumnHideTitleText ColumnReadAccess ColumnStartValue 
(Page 379) (Page 382) (Page 384) (Page 387) 
ColumnCaption (Page 380) | Columnindex (Page 382) ColumnReadonly (Page 384) | ColumnStringLength 
(Page 387) 
ColumnCount (Page 380) ColumnLeadingZeros ColumnRepos (Page 385) ColumnTimeFormat 
(Page 383) (Page 388) 


ColumnDateFormat 


ColumnLength (Page 383) 


ColumnShowDate 


ColumnType (Page 389) 


(Page 380) (Page 386) 
ColumnDMVarName ColumnMaxValue (Page 383) | ColumnShowlcon (Page 386) | ColumnVisible (Page 389) 
(Page 380) 


ColumnExponentialFormat 
(Page 381) 


ColumnMinValue (Page 383) 


ColumnShowTitlelcon 
(Page 386) 


ColumnWriteAccess 
(Page 389) 


ColumnFlagNotNull 
(Page 381) 


ColumnName (Page 383) 
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See also 


GetColumn method (Page 720) 


GetColumnCollection method (Page 721) 


HitlistColumn object (list) 


Description 


The listing of controls is a data container that can save a number of objects of the same type 
(users can change the number). 


Use the "HitlistColumn" listing object to configure the message blocks used in the hitlist of 
WinCC AlarmControl. 


Use in the controls 


e WinCC AlarmControl (Page 241) 


Available properties of the object 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. For example, when using "hitlistobj.HitlistColumnName", the listing name 
"HitlistColumn" is dropped: "hitlistobj.Name". 


Note that properties are available for WinCC controls that can have the effect of methods. 
These properties are characterized by the respective names, e.g. "Add", "Remove" or 


"Rename". 


HitlistColumnAdd (Page 445) 


HitlistColumnRepos (Page 446) 


HitListMaxSourceltems (Page 448) 


HitlistColumnAutoAdjust (Page 445) 


HitlistColumnSort (Page 447) 


HitListWaxSourceltemsWarn 
(Page 448) 


HitlistColumnCount (Page 445) 


HitlistColumnSortIndex (Page 447) 


HitListRelTime (Page 448) 


HitlistColumnindex (Page 446) 


HitlistColumnVisible (Page 447) 


HitListRelTimeFactor (Page 449) 


HitlistColumnName (Page 446) 


HitListDefaultSort (Page 447) 


HitListRelTimeFactorType (Page 449) 


HitlistColumnRemove (Page 446) 


See also 


GetHitlistColumn method (Page 722) 
GetHistlistColumnCollection method (Page 723) 
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MessageBlock object (list) 


Description 


The listing of controls is a data container that can save a number of objects of the same type 
(users can change the number). 


Use the "MessageBlock" listing object to configure the message blocks in WinCC 
AlarmControl. 


Use in the controls 
e WinCC AlarmControl (Page 241) 


Available properties of the object 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. For example, when using "messageobj.MessageBlockName", the listing name 
"MessageBlock" is dropped: "messageobj.Name". 


MessageBlockAlign MessageBlockFlashOn MessageBlockLength MessageBlockShowlcon 
(Page 495) (Page 497) (Page 500) (Page 501) 
MessageBlockAutoPreci- MessageBlockHideText MessageBlockName MessageBlockShowTitlelcon 
sions (Page 495) (Page 498) (Page 500) (Page 501) 
MessageBlockCaption MessageBlockHideTitleText | MessageBlockPrecisions MessageBlockTextld 
(Page 496) (Page 498) (Page 500) (Page 501) 
MessageBlockCount MessageBlockID (Page 498) | MessageBlockSelected MessageBlockTimeFormat 
(Page 496) (Page 500) (Page 502) 
MessageBlockDateFormat MessageBlocklIndex MessageBlockShowDate MessageBlockType 
(Page 499) (Page 501) (Page 502) 
MessageBlockExponential- | MessageBlockLeadingZeros 
Format (Page 497) (Page 499) 
See also 


GetMessageBlock method (Page 724) 
GetMessageBlockCollection method (Page 725) 


MessageColumn object (list) 


Description 


The listing of controls is a data container that can save a number of objects of the same type 
(users can change the number). 


Use the "MessageColumn" listing object to configure the message blocks used in the message 
lists of WinCC AlarmControl. 
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Use in the controls 
e WinCC AlarmControl (Page 241) 


Available properties of the object 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. For example, when using "messagecol.MessageColumnName", the listing name 


"MessageColumn" is dropped: "messagecol.Name". 


Note that properties are available for WinCC controls that can have the effect of methods. 
These properties are characterized by the respective names, e.g. "Add", "Remove" or 


"Rename". 


MessageColumnAdd (Page 503) MessageColumnName (Page 504) 


MessageColumnSort (Page 505) 


MessageColumnAutoAdjust (Page 503) | MessageColumnRemove (Page 504) 


MessageColumnSortIndex (Page 505) 


MessageColumnCount (Page 504) MessageColumnRepos (Page 505) 


MessageColumnVisible (Page 505) 


MessageColumnindex (Page 504) 


See also 
GetMessageColumn method (Page 727) 
GetMessageColumnCollection method (Page 728) 


OperatorMessage object (list) 


Description 


The listing of controls is a data container that can save a number of objects of the same type 


(users can change the number). 


Use the "OperatorMessage" listing object to configure the operator messages displayed in 


WinCC AlarmControl. 


Use in the controls 
e WinCC AlarmControl (Page 241) 
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If you access the properties with the listing object, you do not have to enter the name of the 


listing. For example, when using "opmessobj.OperatorMessageName", the listing name 


"OperatorMessage" is dropped: "opmessobj.Name". 


OperatorMessagelD (Page 518) 


OperatorMessageSourced (Page 520) 


OperatorMessageSourceT ype3 
(Page 523) 


OperatorMessagelndex (Page 518) 


OperatorMessageSource6 (Page 521) 


OperatorMessageSourceType4 
(Page 523) 


OperatorMessageName (Page 518) 


OperatorMessageSource7 (Page 521) 


OperatorMessageSourceTyped5 
(Page 523) 


OperatorMessageNumber (Page 519) 


OperatorMessageSource8 (Page 521) 


OperatorMessageSourceT ype6 
(Page 524) 


OperatorMessageSelected (Page 519) 


OperatorMessageSource9 (Page 522) 


OperatorMessageSourceType7 
(Page 524) 


OperatorMessageSource1 (Page 519) 


OperatorMessageSource10 (Page 522) 


OperatorMessageSourceT ype8& 
(Page 524) 


OperatorMessageSource2 (Page 519) 


OperatorMessageSourceType1 
(Page 522) 


OperatorMessageSourceType9 
(Page 525) 


OperatorMessageSource3 (Page 520) 


OperatorMessageSourceType2 
(Page 522) 


OperatorMessageSourceType10 
(Page 525) 


OperatorMessageSource4 (Page 520) 


See also 


GetOperatorMessage method (Page 729) 


GetOperatorMessageCollection method (Page 730) 


Row object (list) 


Description 


The listing of controls is a data container that can save a number of objects of the same type 
(users can change the number). 


Use the "Row" listing object to access the rows of the table-based controls. The Row object 
refers to the runtime data in the tables. 


Use in the controls 


WinCC AlarmControl (Page 241) 


WinCC OnlineTableControl (Page 257) 


WinCC RulerControl (Page 272) 


WinCC UserArchiveControl (Page 280) 
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Available methods of the object 


SelectAll (Page 797) SelectRow (Page 798) 


UnselectAll (Page 812) UnselectRow (Page 813) 


Available properties of the object 
@ Count (Page 394) 


Example 

'VBS371 

Dim mycontrol 

Set mycontrol = ScreenItems.Item("Controll") 

Dim rowobj 

Set rowobj = mycontrol.GetRowCollection 

"Reading the property Count of the collection 

HMTRuntime.Trace "RowCount: " & rowobj.Count & vbNewline 

"Reading the properties CellText, CellCount an RowNumber for the items of the collection 
For lIndex = 1 To rowobj.Count 

‘In this example the CellText of the third column is returned 

HMTRuntime.Trace "RowCellText: " & lIndex & ": " & rowobj.item(lIndex) .CellText(3) & 
vbNewline 

HMIRuntime.Trace "RowCellCount: " & lIndex & ": " & rowobj.item(lIndex).CellCount & 
vbNewline 

HMIRuntime.Trace "“RowNumber: " & rowobj.item(lIndex) .RowNumber & vbNewline 

Next 
See also 


GetRow method (Page 731) 
GetRowCollection method (Page 732) 
GetSelectedRow method (Page 738) 
GetSelectedRows method (Page 739) 
CellCount property (Page 364) 
CellText property (Page 366) 
RowNumber property (Page 553) 


RulerBlock object (list) 


Description 


The listing of controls is a data container that can save a number of objects of the same type 
(users can change the number). 
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Use the "Block" listing object to configure the blocks of WinCC RulerControl. 


Use in the controls 
e WinCC RulerControl (Page 272) 


Available properties of the object 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. For example, when using "rulerblockobj.BlockName", the listing name "Block" is 
dropped: "rulerblockobj.Name". 


BlockAlign (Page 347) BlockHideText (Page 349) BlockPrecisions (Page 351) 

BlockAutoPrecisions (Page 348) BlockHideTitleText (Page 349) BlockShowDate (Page 351) 

BlockCaption (Page 348) BlockID BlockShowlcon (Page 351) 

BlockCount (Page 348) BlockIndex (Page 350) BlockShowTitlelcon (Page 352) 

BlockDateFormat (Page 348) BlockLength (Page 351) BlockTimeFormat (Page 352) 

BlockExponentialFormat (Page 349) BlockName (Page 351) BlockUseSourceFormat (Page 352) 
See also 


GetRulerBlock method (Page 733) 
GetRulerBlockCollection method (Page 734) 


RulerColumn object (list) 


Description 


The listing of controls is a data container that can save a number of objects of the same type 
(users can change the number). 


Use the "Column" listing object to configure the columns of the ruler window in WinCC 
RulerControl. 


Use in the controls 
e WinCC RulerControl (Page 272) 


Available properties of the object 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. For example, when using "rulercolobj.ColumnName", the listing name "Column" is 
dropped: "rulercolobj.Name". 
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Note that properties are available for WinCC controls that can have the effect of methods. 
These properties are characterized by the respective names, e.g. "Add", "Remove" or 
"Rename". 


ColumnAdd (Page 379) 
ColumnCount (Page 380) 
ColumnIndex (Page 382) 


ColumnName (Page 383) ColumnSort (Page 387) 
ColumnSortIndex (Page 387) 


ColumnVisible (Page 389) 


ColumnRemove (Page 384) 


ColumnRepos (Page 385) 


See also 
GetRulerColumn method (Page 735) 
GetRulerColumnCollection method (Page 736) 


StatisticAreaColumn object (list) 


Description 


The listing of controls is a data container that can save a number of objects of the same type 
(users can change the number). 


Use the "Column" listing object to configure the columns of the statistic area window in WinCC 
RulerControl. 


Use in the controls 
e WinCC RulerControl (Page 272) 


Available properties of the object 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. For example, when using "statareacolobj.ColumnName", the listing name "Column" is 
dropped: "statareacolobj.Name". 


Note that properties are available for WinCC controls that can have the effect of methods. 
These properties are characterized by the respective names, e.g. "Add", "Remove" or 
"Rename". 


ColumnAdd (Page 379) 


ColumnName (Page 383) 


ColumnSort (Page 387) 


ColumnCount (Page 380) 


ColumnRemove (Page 384) 


ColumnSortIndex (Page 387) 


ColumnIndex (Page 382) 


ColumnRepos (Page 385) 


ColumnVisible (Page 389) 


See also 


GetStatisticAreaColumn method (Page 741) 


GetStatisticAreaColumnCollection method (Page 742) 
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StatisticResultColumn object (list) 


Description 


The listing of controls is a data container that can save a number of objects of the same type 
(users can change the number). 


Use the "Column" listing object to configure the columns of the statistic window in WinCC 
RulerControl. 


Use in the controls 
e WinCC RulerControl (Page 272) 


Available properties of the object 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. For example, when using "statrescolobj.ColumnName", the listing name "Column" is 
dropped: "statrescolobj.Name". 


Note that properties are available for WinCC controls that can have the effect of methods. 
These properties are characterized by the respective names, e.g. "Add", "Remove" or 


"Rename". 
ColumnAdd (Page 379) ColumnName (Page 383) ColumnSort (Page 387) 
ColumnCount (Page 380) ColumnRemove (Page 384) ColumnSortIndex (Page 387) 
ColumnIndex (Page 382) ColumnRepos (Page 385) ColumnVisible (Page 389) 


See also 
GetStatisticResultColumn method (Page 743) 
GetStatisticResultColumnCollection method (Page 744) 


StatusbarElement object (list) 


Description 


The listing of controls is a data container that can save a number of objects of the same type 
(users can change the number). 


Use the "StatusbarElement" listing object to configure the properties of the statusbar of the 
controls. 
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Use in the controls 


WinCC AlarmControl (Page 241) 


WinCC FunctionTrendControl 
(Page 248) 


WinCC OnlineTableControl (Page 257) 


WinCC OnlineTrendControl (Page 262) 


WinCC RulerControl (Page 272) 


WinCC UserArchiveControl (Page 280) 


Available properties of the object 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. For example, when using "statusbarobj.StatusbarElementName", the listing name 


"StatusbarElement" is dropped: "statusbarobj.Name". 


Note that properties are available for WinCC controls that can have the effect of methods. 
These properties are characterized by the respective names, e.g. "Add", "Remove" or 


"Rename". 


StatusbarElementAdd (Page 589) 


StatusbarElementIndex (Page 590) 


StatusbarElementText (Page 591) 


StatusbarElementAutoSize (Page 589) 


StatusbarElementName (Page 590) 


StatusbarElementTooltipText 


(Page 591) 
StatusbarElementCount (Page 589) StatusbarElementRemove StatusbarElementUserDefined 
(Page 590) (Page 592) 
StatusbarElementliconld (Page 589) StatusbarElementRename StatusbarElementVisible (Page 591) 
(Page 590) 


StatusbarElementid (Page 589) 


StatusbarElementRepos (Page 591) 


StatusbarElementWidth (Page 592) 


See also 


GetStatusbarElement method (Page 745) 
GetStatusbarElementCollection method (Page 746) 


TimeAxis object (list) 


Description 


The listing of controls is a data container that can save a number of objects of the same type 
(users can change the number). 


Use the "TimeAxis" listing object to configure the properties of the time axis in columns in the 
WinCC OnlineTrendControl. 


Use in the controls 


e WinCC OnlineTrendControl (Page 262) 
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If you access the properties with the listing object, you do not have to enter the name of the 
listing. For example, when using "timeaxisobj. TimeAxisName", the listing name "TimeAxis" is 


dropped: "timeaxisobj.Name". 


Note that properties are available for WinCC controls that can have the effect of methods. 
These properties are characterized by the respective names, e.g. "Add", "Remove" or 


"Rename". 
TimeAxisActualize TimeAxisIndex (Page 605) TimeAxisRepos (Page 607) 
TimeAxisAdd (Page 603) TimeAxisInTrendColor TimeAxisShowDate (Page 608) 
TimeAxisAlign (Page 603) TimeAxisLabel (Page 606) TimeAxisTimeFormat (Page 608) 
TimeAxisBeginTime (Page 603) TimeAxisMeasurePoints (Page 606) TimeAxisTimeRangeBase (Page 608) 
TimeAxisColor (Page 604) TimeAxisName (Page 606) TimeAxisTimeRangeFactor (Page 609) 
TimeAxisCount (Page 604) TimeAxisRangeType (Page 607) TimeAxisTrendWindow (Page 609) 
TimeAxisDateFormat (Page 604) TimeAxisRemove (Page 607) TimeAxisVisible (Page 609) 
TimeAxisEndTime (Page 604) TimeAxisRename (Page 607) 


See also 


GetTimeAxis method (Page 747) 
GetTimeAxisCollection method (Page 748) 


TimeColumn object (list) 


Description 


The listing of controls is a data container that can save a number of objects of the same type 


(users can change the number). 


Use the "TimeColumn" listing object to configure the properties of the time column in WinCC 


OnlineTrendControl. 


Use in the controls 


e WinCC OnlineTableControl (Page 257) 


Available properties of the object 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. For example, when using "timecolobj. TimeColumnName", the listing name 


"TimeColumn" is dropped: "timecolobj.Name". 
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Note that properties are available for WinCC controls that can have the effect of methods. 
These properties are characterized by the respective names, e.g. "Add", "Remove" or 


"Rename". 


TimeColumnActualize (Page 610) 


TimeColumnHideText (Page 613) 


TimeColumnShowDate (Page 616) 


TimeColumnAdd (Page 610) 


TimeColumnHideTitleText (Page 614) 


TimeColumnShowlcon (Page 616) 


TimeColumnAlign (Page 611) 


TimeColumnindex (Page 614) 


TimeColumnShowTitlelcon (Page 616) 


TimeColumnBackColor (Page 611) 


TimeColumnLength (Page 614) 


TimeColumnSort (Page 617) 


TimeColumnBeginTime (Page 612) 


TimeColumnMeasurePoints (Page 614) 


TimeColumnSortIndex (Page 617) 


TimeColumnCaption (Page 612) 


TimeColumnName (Page 615) 


TimeColumnTimeFormat (Page 617) 


TimeColumnCount (Page 612) 


TimeColumnRangeType (Page 615) 


TimeColumnTimeRangeBase 
(Page 618) 


TimeColumnDateFormat (Page 612) 


TimeColumnRemove (Page 615) 


TimeColumnTimeRangeFactor 
(Page 618) 


TimeColumnEndTime (Page 613) 


TimeColumnRename (Page 615) 


TimeColumnUseValueColumnColors 
(Page 618) 


TimeColumnForeColor (Page 613) 


TimeColumnRepos (Page 616) 


TimeColumnVisible (Page 618) 


See also 


GetTimeColumn method (Page 750) 


GetTimeColumnCollection method (Page 751) 


ToolbarButton object (list) 


Description 


The listing of controls is a data container that can save a number of objects of the same type 
(users can change the number). 


Use the "ToolbarButton" listing object to configure the properties of the toolbar of the controls. 


Use in the controls 


WinCC AlarmControl (Page 241) 


WinCC FunctionTrendControl 
(Page 248) 


WinCC OnlineTableControl (Page 257) 


WinCC OnlineTrendControl (Page 262) 


WinCC RulerControl (Page 272) 


WinCC UserArchiveControl (Page 280) 


Available properties of the object 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. For example, when using "toolbarobj. ToolbarButtonName", the listing name 
"ToolbarButton" is dropped: "toolbarobj.Name". 
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Note that properties are available for WinCC controls that can have the effect of methods. 
These properties are characterized by the respective names, e.g. "Add", "Remove" or 


"Rename". 


ToolbarButtonActive (Page 630) 


ToolbarButtonld (Page 635) 


ToolbarButtonRename (Page 637) 


ToolbarButtonAdd (Page 630) 


ToolbarButtonIndex (Page 636) 


ToolbarButtonRepos (Page 637) 


ToolbarButtonBeginGroup (Page 630) 


ToolbarButtonLocked (Page 636) 


ToolbarButtonTooltipText (Page 638) 


ToolbarButtonCount (Page 635) 


ToolbarButtonName (Page 636) 


ToolbarButtonUserDefined (Page 638) 


ToolbarButtonEnabled (Page 635) 


ToolbarButtonPasswordLevel 
(Page 636) 


ToolbarButtonVisible (Page 638) 


ToolbarButtonHotKey (Page 635) 


ToolbarButtonRemove (Page 636) 


See also 


GetToolbarButton method (Page 752) 
GetToolbarButtonCollection method (Page 753) 


Trend object (list) 


Description 


The listing of controls is a data container that can save a number of objects of the same type 


(users can change 


the number). 


Use the "Trend" listing object to configure the properties of the trends. The "InsertData" and 
"RemoveData" methods are used to fill the trend with data or to delete the trend. The 
"GetRulerData" method is used to access the data at a particular point of the trend. 


Use in the controls 


WinCC FunctionTrendControl (Page 248) 


WinCC OnlineTrendControl (Page 262) 


Available methods of the object 


GetRulerData (Page 737) 


InsertData (Page 769) 


RemoveData (Page 794) 


Available properties of the object 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. For example, when using "trendobj.Trendname", the listing name "Trend" is dropped: 


"trendobj.Name". 


Note that properties are available for WinCC controls that can have the effect of methods. 
These properties are characterized by the respective names, e.g. "Add", "Remove" or 


"Rename". 
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Properties in WinCC FunctionTrendControl and WinCC OnlineTrendControl 


TrendAdd (Page 645) 


TrendLineWidth (Page 650) 


TrendRemove (Page 654) 


TrendColor (Page 647) 


TrendLowerLimit (Page 650) 


TrendRename (Page 654) 


TrendCount (Page 647) 


TrendLowerLimitColor (Page 650) 


TrendRepos (Page 654) 


TrendExtendedColorSet 


TrendLowerLimitColoring (Page 651) 


TrendTrendWindow (Page 657) 


TrendFill (Page 648) 


TrendName (Page 651) 


TrendUncertainColor (Page 657) 


TrendFillColor (Page 648) 


TrendPointColor (Page 651) 


TrendUncertainColoring (Page 658) 


TrendIndex (Page 649) 


TrendPointStyle 


TrendUpperLimit (Page 658) 


TrendLabel (Page 649) 


TrendPointWidth (Page 652) 


TrendUpperLimitColor (Page 658) 


TrendLineStyle (Page 649) 


TrendProvider (Page 652) 


TrendUpperLimitColoring (Page 658) 


TrendLineType (Page 650) 


TrendProviderCLSID (Page 653) 


TrendVisible (Page 660) 


Properties in WinCC OnlineTrendControl 


TrendAutoRangeBeginTagName 
(Page 645) 


TrendAutoRangeSource (Page 646) 


TrendValueAlignment 


TrendAutoRangeBeginValue 
(Page 646) 


TrendSelectTagName (Page 654) 


TrendValueAxis (Page 659) 


TrendAutoRangeEndTagName 
(Page 646) 


TrendTagName (Page 656) 


TrendValueUnit 


TrendAutoRangeEndValue (Page 646) 


TrendTimeAxis (Page 656) 


Properties in the WinCC FunctionTrendControl 


TrendActualize (Page 645) 


TrendSelectTagNamexX (Page 655) 


TrendTimeRangeBase (Page 656) 


TrendBeginTime (Page 647) 


TrendSelectTagNameY (Page 655) 


TrendTimeRangeFactor (Page 657) 


TrendEndTime (Page 648) 


TrendTagNamex (Page 656) 


TrendXAxis (Page 666) 


TrendMeasurePoints (Page 651) 


TrendTagNameyY (Page 656) 


TrendYAxis (Page 666) 


TrendRangeType 


See also 


GetTrend method (Page 754) 
GetTrendCollection method (Page 755) 


TrendWindow object (list) 


Description 


The listing of controls is a data container that can save a number of objects of the same type 
(users can change the number). 


Use the "TrendWindow" listing object to configure the properties of the trend window. 
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Use in the controls 


WinCC FunctionTrendControl (Page 248) WinCC OnlineTrendControl (Page 262) 


Available properties of the object 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. For example, when using "trendwndobj.TrendWindowName", the listing name 
"TrendWindow" is dropped: "trendwndobj.Name". 


Note that properties are available for WinCC controls that can have the effect of methods. 
These properties are characterized by the respective names, e.g. "Add", "Remove" or 


"Rename". 


Properties in WinCC FunctionTrendControl and WinCC OnlineTrendControl 


TrendWindowAdd (Page 660) 


TrendWindowGridInTrendColor 
(Page 662) 


TrendWindowRulerColor (Page 663) 


TrendWindowCoarseGrid (Page 660) 


TrendWindowHorizontalGrid 
(Page 662) 


TrendWindowRulerLayer 


TrendWindowCoarseGridColor 
(Page 660) 


TrendWindowlIndex (Page 662) 


TrendWindowRulerStyle (Page 664) 


TrendWindowCount (Page 661) 


TrendWindowRulerWidth (Page 664) 


TrendWindowFineGrid (Page 661) 


TrendWindowName (Page 662) 
TrendWindowRemove (Page 663) 


TrendWindowSpacePortion (Page 664) 


TrendWindowFineGridColor 
(Page 661) 


TrendWindowRename (Page 663) 


TrendWindowVerticalGrid (Page 665) 


TrendWindowF oregroundTrendGrid 


TrendWindowRepos (Page 663) 


TrendWindowVisible (Page 666) 


(Page 661) 


Properties in WinCC OnlineTrendControl 


TrendWindowStatisticRulerColor 
(Page 665) 


TrendWindowStatisticRulerWidth 
(Page 665) 


TrendWindowStatisticRulerStyle 
(Page 665) 


See also 
GetTrendWindow method (Page 757) 
GetTrendWindowCollection method (Page 758) 


ValueAxis object (list) 


Description 


The listing of controls is a data container that can save a number of objects of the same type 
(users can change the number). 


Use the "ValueAxis" listing object to configure the properties of the value axis in WinCC 
OnlineTrendControl. 
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Use in the controls 


@ WinCC OnlineTrendControl (Page 262) 


Available properties of the object 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. For example, when using "valueaxisobj. ValueAxisName", the listing name "ValueAxis" 


is dropped: "valueaxisobj.Name". 


Note that properties are available for WinCC controls that can have the effect of methods. 
These properties are characterized by the respective names, e.g. "Add", "Remove" or 


"Rename". 


ValueAxisAdd (Page 681) 


ValueAxisEndValue (Page 683) 


ValueAxisRemove (Page 686) 


ValueAxisAlign (Page 681) 


ValueAxisExponentialFormat 
(Page 684) 


ValueAxisRename (Page 686) 


ValueAxisAutoPrecisions (Page 682) 


ValueAxisIndex (Page 684) 


ValueAxisRepos (Page 686) 


ValueAxisAutoRange (Page 682) 


ValueAxisInTrendColor 


ValueAxisScalingType (Page 687) 


ValueAxisBeginValue (Page 683) 


ValueAxisLabel (Page 685) 


ValueAxisTrendWindow (Page 687) 


ValueAxisColor (Page 683) 


ValueAxisName (Page 685) 


ValueAxisVisible (Page 687) 


ValueAxisCount (Page 683) 


ValueAxisPrecisions (Page 686) 


See also 


GetValueAxis method (Page 759) 
GetValueAxisCollection method (Page 760) 


ValueColumn object (list) 


Description 


The listing of controls is a data container that can save a number of objects of the same type 


(users can change the number). 


Use the "ValueColumn" listing object to configure the properties of the value column in WinCC 


OnlineTrendControl. 


Use in the controls 


@ WinCC OnlineTableControl (Page 257) 


Available properties of the object 


If you access the properties with the listing object, you do not have to enter the name of the 


listing. For example, when using "valcolobj.ValueColumnName", the listing name 
"ValueColumn" is dropped: "valcolobj.Name". 
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Note that properties are available for WinCC controls that can have the effect of methods. 
These properties are characterized by the respective names, e.g. "Add", "Remove" or 


"Rename". 
ValueColumnAdd (Page 687) ValueColumnHideTitleText (Page 690) | ValueColumnRepos (Page 692) 
ValueColumnAlign (Page 688) ValueColumnindex (Page 690) ValueColumnSelectTagName 

(Page 693) 

ValueColumnAutoPrecisions ValueColumnLength (Page 691) ValueColumnShowlcon (Page 693) 
(Page 688) 
ValueColumnBackColor (Page 689) ValueColumnName (Page 691) ValueColumnShowTitlelcon (Page 693) 
ValueColumnCaption (Page 689) ValueColumnPrecisions (Page 691) ValueColumnSort (Page 693) 
ValueColumnCount (Page 689) ValueColumnProvider (Page 691) ValueColumnSortlndex (Page 694) 
ValueColumnExponentialFormat ValueColumnProviderCLSID ValueColumnTagName (Page 694) 
(Page 689) (Page 692) 
ValueColumnForeColor (Page 690) ValueColumnRemove (Page 692) ValueColumnTimeColumn (Page 694) 
ValueColumnHideText (Page 690) ValueColumnRename (Page 692) ValueColumnVisible (Page 695) 
See also 


GetValueColumn method (Page 761) 
GetValueColumnCollection method (Page 762) 


XAxis object (list) 


Description 


The listing of controls is a data container that can save a number of objects of the same type 
(users can change the number). 


Use the "Xaxis" listing object to configure the properties of the X axis in WinCC 
FunctionTrendControl. 


Use in the controls 
@ WinCC FunctionTrendControl (Page 248) 


Available properties of the object 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. For example, when using "xaxisobj.xXAxisName", the listing name "XAxis" is dropped: 
"xaxisobj.Name". 
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Note that properties are available for WinCC controls that can have the effect of methods. 
These properties are characterized by the respective names, e.g. "Add", "Remove" or 


"Rename". 
XAxisAdd (Page 702) XAxisEndValue (Page 704) XAxisRemove (Page 706) 
XAxisAlign XAxisExponentialFormat (Page 704) XAxisRename (Page 708) 
XAxisAutoPrecisions (Page 703) XAxisIndex (Page 708) XAxisRepos (Page 706) 
XAxisAutoRange (Page 703) XAxisInTrendColor XAxisScalingType (Page 706) 
XAxisBeginValue (Page 703) XAxisLabel (Page 705) XAxisTrendWindow (Page 707) 
XAxisColor (Page 704) XAxisName (Page 705) XAxisVisible (Page 707) 
XAxisCount (Page 707) XAxisPrecisions (Page 706) 


See also 
GetXAxis method (Page 764) 
GetXAxisCollection method (Page 765) 


YAxis object (list) 


Description 


The listing of controls is a data container that can save a number of objects of the same type 
(users can change the number). 


Use the "Yaxis" listing object to configure the properties of the Y axis in WinCC 
FunctionTrendControl. 


Use in the controls 
@ WinCC FunctionTrendControl (Page 248) 


Available properties of the object 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. For example, when using "yaxisobj.YAxisName", the listing name "YAxis" is dropped: 
"yaxisobj.Name". 


Note that properties are available for WinCC controls that can have the effect of methods. 
These properties are characterized by the respective names, e.g. "Add", "Remove" or 


"Rename". 
YAxisAdd (Page 702) YAxisEndValue (Page 704) YAxisRemove (Page 706) 
YAxisAlign (Page 702) YAxisExponentialFormat (Page 704) YAxisRename (Page 709) 
YAxisAutoPrecisions (Page 703) YAxisIndex (Page 708) YAxisRepos (Page 706) 
YAxisAutoRange (Page 703) YAxisInTrendColor (Page 705) YAxisScalingType (Page 706) 
YAxisBeginValue (Page 703) YAxisLabel (Page 705) YAxisTrendWindow (Page 707) 
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YAxisColor (Page 704) 


YAxisName (Page 705) 


YAxisVisible (Page 707) 


YAxisCount (Page 708) 


YAxisPrecisions (Page 706) 


See also 


GetYAxis method (Page 766) 
GetYAxisCollection method (Page 767) 


HMI Symbol Library 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "HMI Symbol Library" 


Type Identifier in VBS 


HM ISymbolLibrary 


Usage 


In the following example, the object with the name "Control1" is moved 20 pixels to the right: 


'VBS64 
Dim objControl 


Set objControl = ScreenItems ("Controll") 
objControl.Left = objControl.Left +20 


Properties 


This object type has the following properties: 
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See also 
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Left Property (Page 476) 
Activate Method (Page 712) 
Properties (Page 301) 


Screenltems Object (List) (Page 129) 


Screenltem Object (Page 125) 
Controls (Page 218) 

Width Property (Page 698) 
Visible Property (Page 696) 
Type Property (Page 666) 

Top Property (Page 643) 
Stretch Property (Page 594) 
Picture Property (Page 536) 
Parent Property (Page 529) 
ObjectName Property (Page 512) 
Object Property (Page 512) 
Layer Object (Page 120) 
Height Property (Page 443) 
ForeColor Property (Page 435) 
Flip Property (Page 429) 
Enabled Property (Page 408) 
Cursor Property (Page 395) 
BlinkColor Property (Page 346) 
BackStyle Property (Page 325) 
BackColor Property (Page 322) 
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Description 


Screens 
Screen 


Screenltems 
Screenltem 
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Object Type of Screenltem Object. Represents the graphic object "WinCC AlarmControl" as 


of WinCC V7.0. 


Type Identifier in VBS 


HMIAlarmControl 


Available list objects 


HitlistColumn (Page 222) 


Row (Page 225) 


MessageBlock (Page 223) 


StatusbarElement (Page 229) 


MessageColumn (Page 223) 


ToolbarButton (Page 232) 


OperatorColumn (Page 224) 


Methods Available in VBS 


Activate 


ActivateDynamic 


AttachDB 


CopyRows 


DeactivateDynamic DetachDB 
Export 
GetHitlistColumn GetOperatorMessage GetStatusbarElement 


GetHitlistColumnCollection 


GetOperatorMessageCollection 


GetStatusbarElementCollection 


GetMessageBlock 


GetRow (Page 731) 


GetToolbarButton 
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GetMessageBlockCollection 


GetRowCollection (Page 732) 


GetToolbarButtonCollection 


GetMessageColumn 


GetSelectedRow (Page 738) 


GetMessageColumnCollection 


GetSelectedRows (Page 739) 


HideAlarm LockAlarm 

LoopInAlarm 

MoveToFirstLine MoveToLastPage MoveToPreviousLine 
MoveToFirstPage MoveToNextLine MoveToPreviousPage 
MoveToLastLine MoveToNextPage 

Print 

QuitHorn QuitSelected QuitVisible 
ShowComment ShowlInfoText ShowSelectionDialog 
ShowDisplayOptionsDialog ShowLockDialog ShowShortTermArchiveList 
ShowEmergencyQuitDialog ShowLockList ShowSortDialog 
ShowHelp ShowLongTermArchiveList ShowTimebaseDialog 
ShowHideList ShowMessageList 

ShowHitList ShowPropertyDialog 

UnhideAlarm UnlockAlarm 


Properties Available in VBS 


If you access the properties with a listing object, you do not have to enter the name of the 
listing. For example, when using "messagecol.MessageColumnName", the listing name 


"MessageColumn" is dropped: "messagecol.Name". 


Note that properties are available for WinCC controls that can have the effect of methods. 
These properties are characterized by the respective names, e.g. "Add", "Remove" or 


"Rename". 
Activate AutoCompleteColumns AutoSelectionColors 
AllServer AutoCompleteRows AutoSelectionRectColor 
ApplyProjectSettings AutoScroll 
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BackColor BorderColor BorderWidth 
Caption CellSpaceRight Column TitleAlign 
CellCut CellSpaceTop ColumnTitles 


CellSpaceBottom 


Closeable 


CellSpaceLeft 


ColumnResize 


DefaultMsgFilterSQL 


DefaultSort2 


DisplayOptions 


DefaultSort 


DefaultSort2Column 


DoubleClickAction 


ExportDirectoryChangeable 


ExportFilenameChangeable 


ExportSelection 


ExportDirectoryname ExportFormatGuid ExportShowDialog 
ExportFileExtension ExportFormatName ExportXML 
ExportFilename ExportParameters 

Font 

GridLineColor GridLineWidth 


HitlistColumnAdd 


HitlistColumnRepos 


HitListWaxSourceltemsWarn 


HitlistColumnAutoAdjust (Page 445) HitlistColumnSort HitListRelTime 
HitlistColumnCount HitlistColumnSortIndex HitListRelTimeFactor 
HitlistColumnindex HitlistColumnVisible HitListRelTimeFactorType 


HitlistColumnName 


HitListDefaultSort 


HorizontalGridLines 


HitlistColumnRemove 


HitListWaxSourceltems 


IconSpace 


LineColor (Page 480) 


LineWidth (Page 481) 


LongTermArchiveConsistency 


MessageBlockAlign 


MessageBlockLength 


MessageColumn!ndex 


MessageBlockAutoPrecisions 


MessageBlockPrecisions 


MessageColumnName 


MessageBlockCaption 
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MessageColumnRemove 
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MessageBlockCount 


MessageBlockShowDate 


MessageColumnRepos 


MessageBlockDateFormat 


MessageBlockShowlcon 


MessageColumnSort 


MessageBlockExponentialFormat 


MessageBlockShowTitlelcon 


MessageColumnSortIndex 


MessageBlockFlashOn MessageBlockTextld MessageColumn Visible 
MessageBlockHideText MessageBlockT ype MessageListT ype 
MessageBlockHideTitleText MessageColumnAdd Moveable 


MessageBlockIndex 


MessageColumnAutoAdjust (Page 503) 


MsgFilterSQL 


MessageBlockLeadingZeros 


MessageColumnCount 


OperatorMessagelD 


OperatorMessageSource5 


OperatorMessageSourceT ype4 


OperatorMessagelndex 


OperatorMessageSource6 


OperatorMessageSourceType5 


OperatorMessageName 
OperatorMessageNumber 


OperatorMessageSource7 
OperatorMessageSource8 


OperatorMessageSourceT ype6 
OperatorMessageSourceType7 


OperatorMessageSelected 


OperatorMessageSource9 


OperatorMessageSourceT ype8& 


OperatorMessageSource1 


OperatorMessageSource10 


OperatorMessageSourceType9 


OperatorMessageSource2 


OperatorMessageSourceType'1 


OperatorMessageSourceType10 


OperatorMessageSource3 


OperatorMessageSourceT ype2 


OperatorMessageSource4 


OperatorMessageSourceT ype3 


PageMode 


PageModeMessageNumber 


PrintJobName 


RowCellCount (Page 364) 


RowScrollbar 


RTPersistencePasswordLevel 


RowCellText (Page 366) 


RowTitleAlign 


RTPersistenceType 


RowCount (Page 394) 
RowNumber (Page 553) 


RowTitles 
RTPersistence 


SelectedCellColor 


SelectionRect 


ShowSortlndex 


SelectedCellForeColor SelectionRectColor ShowTitle 
SelectedRowColor SelectionRectWidth Sizeable 
SelectedRowF oreColor SelectionType SkinName 
SelectedTitleColor ServerNames SortSequence 
SelectedTitleForeColor ShowSortButton 


SelectionColoring 


ShowSortlcon 


StatusbarBackColor 


StatusbarElementName 


StatusbarElementvVisible 


StatusbarElementAdd 


StatusbarElementRemove 


StatusbarElementWidth 


StatusbarElementAutoSize 


StatusbarElementRename 


StatusbarFontColor 
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StatusbarElementCount StatusbarElementRepos StatusbarShowTooltips 
StatusbarElementlconld StatusbarElementText StatusbarText 
StatusbarElementld StatusbarElementTooltipText StatusbarUseBackColor 
StatusbarElementIndex StatusbarElementUserDefined StatusbarVisible 
TableColor TitleColor TitleLightShadowColor 
TableColor2 TitleCut TitleSort 
TableForeColor TitleDarkShadowColor TitleStyle 
TableForeColor2 TitleForeColor 

TimeBase TitleGridLineColor 

ToolbarAlignment ToolbarButtonHotKey ToolbarButtonRepos 


ToolbarBackColor 


ToolbarButtonld 


ToolbarButtonTooltipText 


ToolbarButtonActive 


ToolbarButtonIndex 


ToolbarButtonUserDefined 


ToolbarButtonAdd 


ToolbarButtonLocked 


ToolbarButtonVisible 


ToolbarButtonBeginGroup 


ToolbarButtonName 


ToolbarShowTooltips 


ToolbarButtonClick 


ToolbarButtonPasswordLevel 


ToolbarUseBackColor 


ToolbarButtonCount ToolbarButtonRemove ToolbarUseHotKeys 
ToolbarButtonEnabled ToolbarButtonRename ToolbarVisible 
UseMessageColor UseSelectedTitleColor UseTableColor2 
VerticalGridLines 

Example 


A selection of messages is defined in an existing WinCC AlarmControl. The column properties 
are configured in the script. 


Requirement 


@ A"WinCC AlarmControl" with the name "Control1" has already been inserted in a process 
picture in Graphics Designer. The picture "C_015_Native_Alarms_Sel.pdl" from the demo 
project was used for this example. 


e A button is inserted in the Graphics Designer. You have configured the event "mouse click" 
with a VBS action and the following script for the button. 


@ You have already configured messages in your project. Or you are using the demo project 
from which we have taken the messages used for the example. 


e Messages have already been triggered in Runtime. The buttons "incoming" and "outgoing" 
were clicked in the demo project. 
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"VBS366 

Sub OnClick(ByVal Item) 
Dim objControl 

Dim objMessColumn 

Dim objMessBlock 


Set objControl = ScreenItems ("Controlli") 
objControl.ApplyProjectSettings = False 
Set objMessBlock = objControl.GetMessageBlock ("Date") 


objMessBlock.DateFormat = "dd.MM.yy" 
Set objMessColumn = objControl.GetMessageColumn ("Time") 
objMessColumn.Visible = False 
objControl.MsgFilterSOQL = "MSGNR >= 5 AND Priority = 0" 
End Sub 

Note 


More examples for use of properties and methods are available in the descriptions of the Get 
methods of the controls and under "Examples for VBScript/Examples in WinCC/Dynamizing 
controls". 


See also 

Controls (Page 218) 
WinCC Digital/Analog Clock 
Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "WinCC Digital/Analog 
Clock" 


Type Identifier in VBS 
HMIClock 
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Usage 
In the following example, the object with the name "Control1" is moved 11 pixels to the right: 
'VBS55 
Dim objControl 
Set objControl = ScreenItems ("Controll") 


objControl.Left = objControl.Left +11 


See also 
Parent Property (Page 529) 
Activate Method (Page 712) 
Properties (Page 301) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Controls (Page 218) 
Width Property (Page 698) 
Visible Property (Page 696) 
Type Property (Page 666) 
Top Property (Page 643) 
Ticks Property (Page 601) 
TicksColor Property (Page 601) 
SquareExtent Property (Page 587) 
SecondNeedleWidth Property (Page 563) 
SecondNeedleHeight Property (Page 563) 
Picture Property (Page 536) 
ObjectName Property (Page 512) 
Object Property (Page 512) 
MinuteNeedleWidth Property (Page 507) 
MinuteNeedleHeight Property (Page 507) 
LocalelD Property (Page 482) 
Left Property (Page 476) 
Layer Object (Page 120) 
HourNeedleWidth Property (Page 450) 
HourNeedleHeight Property (Page 450) 
Height Property (Page 443) 
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Handtype Property (Page 443) 
HandFillColor Property (Page 442) 
ForeColor Property (Page 435) 

Font property (before WinCC V7) (Page 431) 
FocusRect Property (Page 430) 

Enabled Property (Page 408) 

BackStyle Property (Page 325) 

BackColor Property (Page 322) 

Analog Property (Page 311) 


WinCC FunctionTrendControl 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "WinCC 


FunctionTrendControl" as of WinCC V7.0. 


Type Identifier in VBS 
HM |FunctionTrendControl 


Available list objects 


StatusbarElement (Page 229) Trend (Page 233) 


XAxis (Page 237) 


ToolbarButton (Page 232) TrendWindow (Page 234) 


YAxis (Page 238) 


Methods Available in VBS 


Activate ActivateDynamic AttachDB 
DeactivateDynamic DetachDB 
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Export 
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GetStatusbarElement GetTrend GetXAxis 
GetStatusbarElementCollection GetTrendCollection GetXAxisCollection 
GetToolbarButton GetTrendWindow GetYAxis 


GetToolbarButtonCollection 


GetTrendWindowCollection 


GetYAxisCollection 


MoveAxis 

NextTrend 

OneToOneView 

PreviousTrend Print 

ShowHelp ShowTagSelection ShowTrendSelection 
ShowPropertyDialog ShowTimeSelection StartStopUpdate 
ZoomArea Zoom|nOutX ZoomMove 
ZoomI|nOut ZoomI|InOutY 


Properties Available in VBS 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. For example, when using "xaxisobj.xXAxisName", the listing name "XAxis" is dropped: 


"xaxisobj.Name". 


Note that properties are available for WinCC controls that can have the effect of methods. 
These properties are characterized by the respective names, e.g. "Add", "Remove" or 


"Rename". 


BackColor 


BorderColor 


BorderWidth 


Caption 


Closeable 


ConnectTrendWindows 
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ExportDirectoryChangeable ExportFilenameChangeable ExportShowDialog 
ExportDirectoryname ExportFormatGuid ExportParameters 
ExportFileExtension ExportFormatName ExportXML 


ExportFilename 


ExportSelection 


Font 

GraphDirection 

LineColor LineWidth LoadDatalmmediately 
Moveable 

Online 

PrintJobName 

RTPersistence RTPersistencePasswordLevel RTPersistenceType 
ShowRuler ShowTitle SkinName 
ShowRulerInAxis Sizeable 

ShowScrollbars ShowTrendicon 


StatusbarBackColor StatusbarElementName StatusbarElementvVisible 
StatusbarElementAdd StatusbarElementRemove StatusbarElementWidth 
StatusbarElementAutoSize StatusbarElementRename StatusbarFontColor 
StatusbarElementCount StatusbarElementRepos StatusbarShowTooltips 
StatusbarElementlconld StatusbarElementText StatusbarText 
StatusbarElementld StatusbarElementTooltipText StatusbarUseBackColor 
StatusbarElementIndex StatusbarElementUserDefined StatusbarVisible 
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TimeBase 


ToolbarButtonHotKey 


7.14 VBS Reference 


ToolbarButtonTooltipText 


ToolbarAlignment 


ToolbarButtonld 


ToolbarButtonUserDefined 


ToolbarBackColor 


ToolbarButtonIndex 


ToolbarButtonVisible 


ToolbarButtonActive 


ToolbarButtonLocked 


ToolbarShowTooltips 


ToolbarButtonAdd 


ToolbarButtonName 


ToolbarUseBackColor 


ToolbarButtonBeginGroup ToolbarButtonPasswordLevel ToolbarUseHotKeys 
ToolbarButtonClick ToolbarButtonRemove ToolbarVisible 
ToolbarButtonCount ToolbarButtonRename 

ToolbarButtonEnabled ToolbarButtonRepos 

TrendActualize TrendLowerLimit TrendSelectTagNamexX 
TrendAdd TrendLowerLimitColor TrendSelectTagNameY 
TrendBeginTime TrendLowerLimitColoring TrendTagNamex 
TrendColor TrendMeasurePoints TrendTagNameY 
TrendCount TrendName TrendTimeRangeBase 
TrendEndTime TrendPointColor TrendTimeRangeFactor 
TrendExtendedColorSet TrendPointStyle TrendTrendWindow 
TrendFill TrendPointWidth TrendUncertainColor 
TrendFillColor TrendProvider TrendUncertainColoring 
Trendindex TrendProviderCLSID TrendUpperLimit 
TrendLabel TrendRangeType TrendUpperLimitColor 
TrendLineStyle TrendRemove TrendUpperLimitColoring 
TrendLineType TrendRename TrendVisible 
TrendLineWidth TrendRepos 

TrendWindowAdd TrendWindowHorizontalGrid TrendWindowRulerStyle 
TrendWindowCoarseGrid TrendWindowlIndex TrendWindowRulerWidth 
TrendWindowCount TrendWindowName TrendWindowSpacePortion 
TrendWindowCoarseGridColor TrendWindowRemove TrendWindowVerticalGrid 
TrendWindowFineGrid TrendWindowRename TrendWindowVisible 
TrendWindowFineGridColor TrendWindowRepos TrendXAxis 
TrendWindowF oregroundTrendGrid TrendWindowRulerColor TrendYAxis 
TrendWindowGridInTrendColor TrendWindowRulerLayer 

UseTrendNameAsLabel 

XAxisAdd XAxisEndValue XAxisRemove 

XAxisAlign XAxisExponentialFormat XAxisRename / YAxisRename 
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XAxisAutoPrecisions XAxisIndex / YAxisIndex XAxisRepos 
XAxisAutoRange XAxisInTrendColor XAxisScalingType 
XAxisBeginValue XAxisLabel XAxisTrendWindow 
XAxisColor XAxisName XAxisVisible 
XAxisCount / YAxisCount XAxisPrecisions 
Examples 


A trend is displayed in a WinCC FunctionTrendControl that is linked with a user archive. 
Different properties are configured for the trend in the script. The "StartID" of the user archive 
and the number of measurement points is changed regarding data connection. 


Requirement 


e A"WinCC FunctionTrendControl" with the name "Control1" is inserted in a process picture 
in Graphics Designer. 


e A button is inserted in the Graphics Designer. You have configured the event "mouse click" 
with a VBS action and the following script for the button. 


@ You have already configured a user archive in your project. Or you are using the demo 
project from which we have taken the user archive for the example. 
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Sub OnClick(ByVal Item) 
Dim objFXControl 

Dim objTrendWindow 

Dim objTrend 

Dim objXAxis 

Dim obj YAxis 

Dim startID 

Dim FXServerDataxX (3) 
Dim FXServerDatayY (3) 

" create reference to FXControl 


= 


Set objFXControl = ScreenItems ("Controll") 
' create reference to new window, x and y axis 


7.14 VBS Reference 


Set objTrendWindow = objFXControl.GetTrendWindowCollection.AddItem ("myWindow") 
Set objXAxis = objFXControl.GetXAxisCollection.AddItem ("myXAxis") 
Set objJYAxis = objFXControl.GetYAxisCollection.AddItem ("myYAxis") 


' assign x and y axis to the window 


obj XAxis.TrendWindow = objTrendWindow.Name 
obj JYAxis.TrendWindow = objTrendWindow.Name 


" add new trend 


Set objTrend = objFXControl.GetTrendCollection.AddItem ("myTrend1") 


" configure trend data connection (UserArchive) 


objTrend.Provider = 3 

startID = CLng(4) 
FXServerDataX(0) = "Setpoint" 
FXServerDataX(1) = "ParabelX" 
FXServerDataxX(3) = startID 
FXServerDataY(0) = "Setpoint" 
FXServerDataY(1) = "ParabelY" 
FXServerDataY(3) = startID 
objTrend.MeasurePoints = 50 


objTrend.SetTagName "Setpoint\ParabelX", 


" assign trend properties 
objTrend.Color = RGB(255,0,0) 
objTrend.PointStyle = 1 


objTrend.TrendWindow = objTrendWindow. Name 


"Setpoint\ParabelY", FXServerDataX, FXServerDataY 


objTrend.XAxis = objXAxis.Name 
objTrend.YAxis = obj YAxis.Name 
End Sub 

Note 


More examples for use of properties and methods are available in the descriptions of the Get 
methods of the controls and under "Examples for VBScript/Examples in WinCC/Dynamizing 


controls". 


See also 
Controls (Page 218) 
ServerDataX (Page 569) 
ServerDataY (Page 570) 
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WinCC Gauge Control 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "WinCC Gauge Control" 


Type Identifier in VBS 


Usage 


"'VBS58 


Dim objControl 


HMIGauge 


In the following example, the object with the name "Control1" is moved 14 pixels to the right: 


Set objControl = ScreenItems ("Controlli") 
objControl.Left = objControl.Left +14 


See also 
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WarningColor Property (Page 697) 
Object Property (Page 512) 
BackColor Property (Page 322) 
Activate Method (Page 712) 
Properties (Page 301) 

Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Object types of the Screenltem object (Page 143) 
Width Property (Page 698) 

Warning Property (Page 697) 

Visible Property (Page 696) 
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ValueMin Property (Page 695) 
ValueMax Property (Page 695) 
ValueColumnAlignment Property (Page 688) 
UnitText Property (Page 672) 
UnitOffset Property (Page 672) 
UnitFont Property (Page 671) 
UnitColor Property (Page 671) 
Type Property (Page 666) 

Top Property (Page 643) 

TicWidth Property (Page 601) 
TicTextOffset Property (Page 600) 
TicTextColor Property (Page 600) 
TicOffset Property (Page 600) 
TicFont Property (Page 599) 
TicColor Property (Page 599) 
ShowWarning Property (Page 579) 
ShowPeak Property (Page 574) 
ShowNormal Property (Page 573) 
ShowDecimalPoint Property (Page 573) 
ShowDanger Property (Page 573) 
Rectangular Property (Page 549) 
Parent Property (Page 529) 
ObjectName Property (Page 512) 
NormalColor Property (Page 510) 
NeedleColor Property (Page 510) 
LocalelD Property (Page 482) 

Left Property (Page 476) 

Layer Object (Page 120) 

Height Property (Page 443) 
FrameScale Property (Page 437) 
FramePicture Property (Page 437) 
FrameColor Property (Page 436) 
Enabled Property (Page 408) 
Delta Property (Page 402) 
DangerColor Property (Page 397) 
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CenterScale Property (Page 366) 
CenterColor Property (Page 366) 
CaptionOffset Property (Page 364) 
CaptionFont Property (Page 363) 
Caption Property (Page 362) 
CaptionColor Property (Page 363) 
BorderWidth Property (Page 355) 
BevelWidth Property (Page 346) 
BevelOuter Property (Page 345) 
Bevellnner Property (Page 345) 
BackStyle Property (Page 325) 


BackgroundPicture Property (Page 324) 


AngleMin Property (Page 313) 
AngleMax Property (Page 312) 


WinCC Media Control 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the "WinCC Media Control" graphic object as 


of WinCC V7.0. 


Object Type of Screenltem Object. Represents the "WinCC Media Control" graphic object as 


of WinCC V7.0. 


Type Identifier in VBS 
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Usage 
In the following example, the object with the name "Control1" is moved 16 pixels to the right: 


"VBS60 

Dim objControl 

Set objControl = ScreenItems ("Controll") 
objControl.Left = objControl.Left 16 


WinCC OnlineTableControl 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "WinCC 
OnlineTableControl" as of WinCC V7.0. 


Type Identifier in VBS 
HM IOnlineTableControl 


Available list objects 


Row (Page 225) ToolbarButton (Page 232) 
StatusbarElement (Page 229) ValueColumn (Page 236) 
TimeColumn (Page 231) 


Methods Available in VBS 


Activate ActivateDynamic AttachDB 


CalculateStatistic CopyRows 
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DeactivateDynamic 


DetachDB 


Edit 


Export 


GetRow (Page 731) 


GetStatusbarElement 


GetToolbarButton 


GetRowCollection (Page 732) 


GetStatusbarElementCollection 


GetToolbarButtonCollection 


GetSelectedRow (Page 738) 


GetTimeColumn 


GetValueColumn 


GetSelectedRows (Page 739) 


GetTimeColumnCollection 


GetValueColumnCollection 


ShowColumnSelection 


ShowTagSelection 


MoveToFirst MoveToNext MoveToPrevious 
MoveToLast 

NextColumn 

PreviousColumn Print 

SelectedStatisticArea ShowPropertyDialog ShowTimeSelection 


StartStopUpdate 


ShowHelp 


Properties Available in VBS 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. For example, when using "timecolobj. TimeColumnName", the listing name 
"TimeColumn" is dropped: "timecolobj.Name". 


Note that properties are available for WinCC controls that can have the effect of methods. 
These properties are characterized by the respective names, e.g. "Add", "Remove" or 


"Rename". 


AutoCompleteColumns 


AutoSelectionColors 


AutoSelectionRectColor 


AutoCompleteRows 
BackColor BorderColor BorderWidth 
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Caption 


CellSpaceRight 


7.14 VBS Reference 


ColumnScrollbar 


CellCut 


CellSpaceTop 


Column TitleAlign 


CellSpaceBottom 


Closeable 


Column Titles 


CellSpaceLeft 


ColumnResize 


EnableEdit 


ExportFilename 


ExportParameters 


ExportDirectoryChangeable 


ExportFilenameChangeable 


ExportSelection 


ExportDirectoryname 


ExportFormatGuid 


ExportShowDialog 


ExportFileExtension 


ExportFormatName 


ExportXML 


Font 


GridLineColor 


GridLineWidth 


HorizontalGridLines 


IconSpace 


LineColor 


LineWidth 


LoadDatalmmediately 


Moveable 


Online 


PrintJobName 


RowCellCount (Page 364) 


RowScrollbar 


RTPersistence 


RowCellText (Page 366) 


RowTitleAlign 


RTPersistencePasswordLevel 


RowCount (Page 394) 


RowTitles 


RTPersistenceType 


RowNumber (Page 553) 
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SelectedCellColor 


SelectionColoring 


ShowSortlcon 


SelectedCellForeColor 


SelectionRect 


ShowSortIndex 


SelectedRowColor SelectionRectColor ShowTitle 
SelectedRowF oreColor SelectionRectWidth Sizeable 
SelectedTitleColor SelectionType SkinName 
SelectedTitleForeColor ShowSortButton SortSequence 


StatusbarBackColor StatusbarElementName StatusbarElementVisible 
StatusbarElementAdd StatusbarElementRemove StatusbarElementWidth 
StatusbarElementAutoSize StatusbarElementRename StatusbarFontColor 
StatusbarElementCount StatusbarElementRepos StatusbarShowTooltips 
StatusbarElementlconld StatusbarElementText StatusbarText 
StatusbarElementld StatusbarElementTooltipText StatusbarUseBackColor 
StatusbarElementIndex StatusbarElementUserDefined StatusbarVisible 
TableColor TableForeColor TimeBase 

TableColor2 TableForeColor2 


TimeColumnActualize 


TimeColumnHideText 


TimeColumnShowDate 


TimeColumnAdd 


TimeColumnHideTitleText 


TimeColumnShowlcon 


TimeColumnAlign 


TimeColumnindex 


TimeColumnShowTitlelcon 


TimeColumnBackColor 


TimeColumnLength 


TimeColumnSort 


TimeColumnBeginTime 


TimeColumnMeasurePoints 


TimeColumnSortIndex 


TimeColumnCaption 


TimeColumnName 


TimeColumnTimeFormat 


TimeColumnCount 


TimeColumnRangeType 


TimeColumnTimeRangeBase 


TimeColumnDateFormat 


TimeColumnRemove 


TimeColumnTimeRangeFactor 


TimeColumnEndTime 


TimeColumnRename 


TimeColumnUseValueColumnColors 


TimeColumnForeColor TimeColumnRepos TimeColumnVisible 
TimeStepBase TitleDarkShadowColor TitleLightShadowColor 
TimeStepFactor TitleForeColor TitleSort 

TitleColor TitleGridLineColor TitleStyle 

TitleCut 

ToolbarAlignment ToolbarButtonHotKey ToolbarButtonRepos 


ToolbarBackColor 


ToolbarButtonld 


ToolbarButtonTooltipText 


ToolbarButtonActive 


ToolbarButtonIndex 


ToolbarButtonUserDefined 
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ToolbarButtonAdd 


ToolbarButtonLocked 


ToolbarButtonVisible 


ToolbarButtonBeginGroup 


ToolbarButtonName 


ToolbarShowTooltips 


ToolbarButtonClick 


ToolbarButtonPasswordLevel 


ToolbarUseBackColor 


ToolbarButtonCount ToolbarButtonRemove ToolbarUseHotKeys 
ToolbarButtonEnabled ToolbarButtonRename ToolbarVisible 
UseColumnBackColor UseSelectedTitleColor UseTableColor2 


UseColumnForeColor 


ValueColumnAdd 


ValueColumnindex 


ValueColumnShowlcon 


ValueColumnAlign 


ValueColumnLength 


ValueColumnShowTitlelcon 


ValueColumnAutoPrecisions 


ValueColumnName 


ValueColumnSort 


ValueColumnBackColor 


ValueColumnPrecisions 


ValueColumnSortIndex 


ValueColumnCaption 


ValueColumnProvider 


ValueColumnState 


ValueColumnCount 


ValueColumnProviderCLSID 


ValueColumnTagName 


ValueColumnExponentialFormat 


ValueColumnRemove 


ValueColumnTimeColumn 


ValueColumnForeColor 


ValueColumnRename 


ValueColumnVisible 


ValueColumnHideText 


ValueColumnRepos 


VerticalGridLines 


ValueColumnHideTitle Text 


ValueColumnSelectTagName 


Example 


An additional column is added in an existing WinCC OnlineTableControl that is linked with an 
archive tag. Different properties are configured for the control and the column in the script. 


Requirement 


@ A"WinCC OnlineTableControl" with the name "Control1" has already been inserted in a 
process picture in Graphics Designer. The control consists of a time column and three value 
columns. The picture "B_025_V7_Arch_TableControl.PDL" from the demo project was used 
for this example. 


e A button is inserted in the Graphics Designer. You have configured the event "mouse click" 
with a VBS action and the following script for the button. 


e You have already configured archives and archive tags in your project. Or you are using 
the demo project from which we have taken the archive for the example. 
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‘VBS362 


Sub OnClick(ByVal Item) 


Dim objControl 


Dim objTimeColumn 


Dim objValueColumn 


Set objControl 


= ScreenlItems ("Controll") 


" Control wide specification 
objControl.ColumnResize = False 
objControl.TimeBase = 1 
objControl.TimeColumnTimeFormat = "HH:mm:ss tt" 
objControl.TimeColumnLength = 20 


properties for Time column 


Set objTimeColumn = objControl.GetTimeColumn ("Time column 1") 
objTimeColumn.DateFormat = "dd/MM/yy" 

' properties for a new 4th value column with connection to archive tag "Trend 4" 
Set objValueColumn = objControl.GetValueColumnCollection.AddItem("Trend 4") 


objValueColumn 


objValueColumn. 
-Align = 1 
objValueColumn. 
objValueColumn. 
objValueColumn. 


objValueColumn 


End Sub 


See also 


-Caption = "Trend 4" 


Length = 10 


Provider = 1 
TagName = "G Archive\Trend 4" 
TimeColumn = "Time column 1" 


a 


Note 


More examples for use of properties and methods are available in the descriptions of the Get 
methods of the controls and under "Examples for VBScript/Examples in WinCC/Dynamizing 
controls". 
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WinCC OnlineTrendControl 


Description 
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Screens 
Screen 


Screenltems 


Screenltem 
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Object Type of Screenltem Object. Represents the graphic object "WinCC 
OnlineTrendControl" as of WinCC V7.0. 


Type Identifier in VBS 


HM |OnlineTrendControl 


Available list objects 


ToolbarButton (Page 232) 


TrendWindow (Page 234) 


StatusbarElement (Page 229) 


TimeAxis (Page 230) 


Trend (Page 233) 


ValueAxis (Page 235) 


Methods Available in VBS 


Activate 


ActivateDynamic-Methode 


AttachDB-Methode 


CalculateStatistic 


DeactivateDynamic 


DetachDB 


Export 

GetStatusbarElement GetToolbarButton (Page 752) GetTrendWindow 
GetStatusbarElementCollection GetToolbarButtonCollection (Page 753) | GetTrendWindowCollection 
GetTimeAxis GetTrend GetValueAxis 


GetTimeAxisCollection 


GetTrendCollection 


GetValueAxisCollection 


MoveAxis MoveToLast MoveToPrevious 
MoveToFirst MoveToNext 

NextTrend 

OneToOneView 

PreviousTrend Print 
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ShowHelp ShowTagSelection StartStopUpdate 
ShowPercentageAxis ShowTimeSelection 

ShowPropertyDialog ShowTrendSelection 

ZoomArea ZoomI|nOutTime ZoomMove 
ZoomI|nOut ZoomI|nOutValues 


Properties Available in VBS 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. For example, when using "trendobj.Trendname", the listing name "Trend" is dropped: 


"trendobj.Name". 


Note that properties are available for WinCC controls that can have the effect of methods. 
These properties are characterized by the respective names, e.g. "Add", "Remove" or 


"Rename". 


BackColor 


BorderColor 


BorderWidth 


Caption 


Closeable 


ConnectTrendWindows 


ExportDirectoryChangeable 


ExportFilenameChangeable 


ExportSelection 


ExportDirectoryname ExportFormatGuid ExportShowDialog 

ExportFileExtension ExportFormatName ExportXML 

ExportFilename ExportParameters 

Font 

GraphDirection 

LineColor LineWidth LoadDatalmmediately 

Moveable 

Online 
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PercentageAxis PercentageAxisColor PrintJobName 
PercentageAxisAlign 

RTPersistence RTPersistencePasswordLevel RTPersistenceType 
ShowRuler ShowStatisticRuler Sizeable 
ShowRulerInAxis ShowTitle SkinName 
ShowScrollbars ShowTrendicon 


StatusbarBackColor StatusbarElementName StatusbarElementVisible 
StatusbarElementAdd StatusbarElementRemove StatusbarElementWidth 
StatusbarElementAutoSize StatusbarElementRename StatusbarFontColor 
StatusbarElementCount StatusbarElementRepos StatusbarShowTooltips 
StatusbarElementlconld StatusbarElementText StatusbarText 
StatusbarElementld StatusbarElementTooltipText StatusbarUseBackColor 
StatusbarElementIndex StatusbarElementUserDefined StatusbarVisible 


TimeAxisActualize 


TimeAxisIndex 


TimeAxisRepos 


TimeAxisAdd 


TimeAxisInTrendColor 


TimeAxisShowDate 


TimeAxisAlign 
TimeAxisBeginTime 


TimeAxisLabel 
TimeAxisMeasurePoints 


TimeAxis TimeFormat 
TimeAxis TimeRangeBase 


TimeAxisColor 


TimeAxisName 


TimeAxis TimeRangeFactor 


TimeAxisCount TimeAxisRangeType TimeAxisTrendWindow 
TimeAxisDateFormat TimeAxisRemove TimeAxisVisible 
TimeAxisEndTime TimeAxisRename TimeBase 


ToolbarAlignment 


ToolbarButtonHotKey 


ToolbarButtonRepos 


ToolbarBackColor 


ToolbarButtonld 


ToolbarButtonTooltipText 


ToolbarButtonActive 


ToolbarButtonIndex 


ToolbarButtonUserDefined 


ToolbarButtonAdd 


ToolbarButtonLocked 


ToolbarButtonVisible 


ToolbarButtonBeginGroup 


ToolbarButtonName 


ToolbarShowTooltips 


ToolbarButtonClick 


ToolbarButtonPasswordLevel 


ToolbarUseBackColor 


ToolbarButtonCount 


ToolbarButtonRemove 


ToolbarUseHotKeys 


ToolbarButtonEnabled 


ToolbarButtonRename 


ToolbarVisible 
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TrendAdd 


TrendLineType 


TrendSelectTagName 


TrendAutoRangeBeginTagName 


TrendLineWidth 


TrendTagName 


TrendAutoRangeBeginValue 


TrendLowerLimit 


TrendTimeAxis 


TrendAutoRangeEndTagName 


TrendLowerLimitColor 


TrendTrendWindow 


TrendAutoRangeEndValue 


TrendLowerLimitColoring 


TrendUncertainColor 


ValueAxisAlign 


ValueAxisExponentialFormat 


TrendAutoRangeSource TrendName TrendUncertainColoring 
TrendColor TrendPointColor TrendUpperLimit 

TrendCount TrendPointStyle TrendUpperLimitColor 
TrendExtendedColorSet TrendPointWidth TrendUpperLimitColoring 
TrendFill TrendProvider TrendValueAlignment 
TrendFillColor TrendProviderCLSID TrendValueAxis 

TrendIndex TrendRemove TrendValueUnit 

TrendLabel TrendRename TrendVisible 

TrendLineStyle TrendRepos 

TrendWindowAdd TrendWindowHorizontalGrid TrendWindowRulerStyle 
TrendWindowCoarseGrid TrendWindowIndex TrendWindowRulerWidth 
TrendWindowCoarseGridColor TrendWindowName TrendWindowSpacePortion 
TrendWindowCount TrendWindowRemove TrendWindowStatisticRulerColor 
TrendWindowFineGrid TrendWindowRename TrendWindowStatisticRulerStyle 
TrendWindowFineGridColor TrendWindowRepos TrendWindowStatisticRulerWidth 
TrendWindowF oregroundTrendGrid TrendWindowRulerColor TrendWindowVerticalGrid 
TrendWindowGridInTrendColor TrendWindowRulerLayer TrendWindowVisible 
UseTrendNameAsLabel 

ValueAxisAdd ValueAxisEndValue ValueAxisRemove 


ValueAxisRename 


ValueAxisAutoPrecisions 


ValueAxisIndex 


ValueAxisRepos 


ValueAxisAutoRange 


ValueAxisInTrendColor 


ValueAxisScalingType 


ValueAxisBeginV alue 


ValueAxisLabel 


ValueAxisTrendWindow 


ValueAxisColor 


ValueAxisName 


ValueAxisVisible 


ValueAxisCount 


ValueAxisPrecisions 


Example 


Three trends are displayed in a WinCC OnlineTrendControl that are linked with archive tags. 


Different properties are configured for the trends in the script. 
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Requirement 


e A"WinCC OnlineTrendControl" with the name "Control1" is inserted in a process picture 
in Graphics Designer. 


e A button is inserted in the Graphics Designer. You have configured the event "mouse click" 
with a VBS action and the following script for the button. 


e You have already configured archives and archive tags in your project. Or you are using 
the demo project from which we have taken the archives for the example. 
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"VBS361 

Sub OnClick(ByVal Item) 

Dim objTrendControl 

Dim objTrendWindow 

Dim objTimeAxis 

Dim objValueAxis 

Dim objTrend 

"create reference to TrendControl 

Set objTrendControl = ScreenItems("Controlli") 
‘create reference to new window, time and value axis 


set 


objTrendWindow = objTrendControl.GetTrendWindowCollection.AddItem("myWindow") 
objTimeAxis = objTrendControl.GetTimeAxisCollection. AddItem ("myTimeAxis") 
objValueAxis = objTrendControl.GetValueAxisCollection.AddItem("myValueAxis") 


‘assign time and value axis to the window 


obj] 


ai 


[TimeAxis.TrendWindow = objTrendWindow.Name 


objValueAxis.TrendWindow = objTrendWindow.Name 
' assign properties to trendwindow 


obj! 


[TrendWindow.HorizontalGrid = False 


' add new trend and assign properties 


Set 
obj] 
obj] 
obj! 
obj] 
obj] 
obj] 
obj] 


objTrend = objTrendControl.GetTrendCollection.AddItem("myTrend1") 
[rend.Provider = 1 

[rend.TagName = "G Archive\Trend_1" 

[Trend.TrendWindow = objTrendWindow. Name 

[rend.TimeAxis = objTimeAxis.Name 

[Trend.ValueAxis = objValueAxis.Name 


[rend.Color = RGB(255,0,0) 
[Trend.PointStyle = 0 


‘add new trend and assign properties 


Set 
obj] 
obj] 
obj] 
obj] 
obj] 
obj] 
obj] 


objTrend = objTrendControl.GetTrendCollection.AddItem("myTrend2") 


[Trend.Provider = 1 

[rend.TagName = "G Archive\Trend_2" 
[Trend.TrendWindow = objTrendWindow. Name 
[rend.TimeAxis = objTimeAxis.Name 
[Trend.ValueAxis = objValueAxis.Name 


[Trend.Color = RGB(0,255,0) 
[Trend.LineWidth = 3 


‘add new trend and assign properties 


Set 
obj! 
obj] 
obj! 
obj! 
obj] 
obj] 


objTrend = objTrendControl.GetTrendCollection.AddItem("myTrend3") 


obj] 
End 
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[Trend.Provider = 1 
[rend.TagName = "G Archive\Trend_3" 
[Trend.TrendWindow = objTrendWindow. Name 
[rend.TimeAxis = objTimeAxis.Name 
[Trend.ValueAxis = objValueAxis.Name 
[Trend.Color = RGB(0,0,255) 
[Trend.LineType = 2 
Sub 

Note 


More examples for use of properties and methods are available in the descriptions of the Get 
methods of the controls and under "Examples for VBScript/Examples in WinCC/Dynamizing 
controls". 
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See also 
Controls (Page 218) 


WinCC Push Button Control 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "WinCC Push Button Control" 


Type Identifier in VBS 
HM|Button 


Usage 
In the following example, the object with the name "Control1" is moved 17 pixels to the right: 


"VBS61 

Dim objControl 

Set objControl = ScreenItems ("Controll") 
objControl.Left = objControl.Left +17 


Note 


The events KeyDown, KeyUp and KeyPress cannot be addressed by VBS. If it is required to 
make controls dynamic with the help of VBS, no parameter must be declared with ByRef. 
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Notes on Error Handling 


On 


On 
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Error Goto 0 


Buttons and pushbuttons are mapped in the object model to an "HMIButton" type. Since the 
objects have different properties, the availability of the property (dynamic type compilation in 
Runtime) should be queried via an exception measure. The exception measure is activated 

for the corresponding procedure by the following instruction: 


Error Resume Next 


The instruction causes the VBScript engine to initiate the follow-on command in the case of a 
Runtime error. 


The error code can subsequently be checked using the Err object. In order to deactivate the 
handling of Runtime errors in scripts, use the following command: 


Handling errors always relates to the procedure layer. If a script in a procedure causes an 
error, VBScript checks whether an error handling measure is implemented in this layer. If not, 
control is transferred one layer up (to the calling procedure). If there is no error handling 
measure here either, the control is transferred yet another layer up. This continues until either 
the top module level is reached or the code for Runtime error handling is located. If the 
activation of the Runtime error handling fails, the control is transferred to the top level on the 
internal VBScript Runtime error handing. This opens an error dialog and stops the script. 


The "On Error Resume Next" command can be installed on all layers (i.e. also in procedures). 
When the error handling measure is use, it can basically be determined whether the user is 
actually using the required implementation type. 


In addition, it can be ensured that there is no termination of execution due to a faulty access 
to the object. 
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Examples of error handling 


"VBS 62 

Dim objScreenItem 

On Error Resume Next "Activation of errorhandling 
For Each objScreenItem In ScreenItems 


If objScreenItem.Type = "HMIButton" Then 
' 


‘=== Property "Text" available only for Standard-Button 

objScreenItem.Text = "Windows" 

If 0 <> Err.Number Then 

HMTRuntime.Trace objScreenItem.ObjectName & ": no Windows-Button" & vbCrLf 
Err.Clear "Delet rror messag 

End If 


=== Property "Caption" available only for PushButton 
objScreenItem.Caption = "Push" 

If 0 <> Err.Number Then 

HMTRuntime.Trace objScreenItem.ObjectName & ": no Control" & vbCrLf 
Err.Clear 

End If 

End If 

ext 


On Error Goto 0 "Deactivation of errorhandling 


See also 
Properties (Page 301) 
FontName Property (Page 433) 
Activate Method (Page 712) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Controls (Page 218) 
Width Property (Page 698) 
Visible Property (Page 696) 
Type Property (Page 666) 
Transparent Property (Page 644) 
Top Property (Page 643) 
PictureUnselected Property (Page 539) 
PictureSelected Property (Page 538) 
Parent Property (Page 529) 
Outline Property (Page 527) 
ObjectName Property (Page 512) 
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Object Property (Page 512) 

Left Property (Page 476) 

Layer Object (Page 120) 

Height Property (Page 443) 
FrameWidth Property (Page 438) 
FrameColorUp Property (Page 437) 
FrameColorDown Property (Page 436) 
ForeColor Property (Page 435) 
FontUnderline Property (Page 434) 
FontStrikeThru Property (Page 434) 
FontSize Property (Page 433) 
Fontltalic Property (Page 432) 

Font property (before WinCC V7) (Page 431) 
FontBold Property (Page 432) 
FocusRect Property (Page 430) 
Enabled Property (Page 408) 

Caption Property (Page 362) 
BackColor Property (Page 322) 
AutoSize Property (Page 319) 


WinCC RulerControl 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "WinCC RulerControl" as 


of WinCC V7.0. 


Type Identifier in VBS 


272 


HM |RulerControl 
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Row (Page 225) 
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StatisticResultColumn (Page 229) 


RulerBlock (Page 226) 


StatusbarElement (Page 229) 


RulerColumn (Page 227) 


ToolbarButton (Page 232) 


StatisticAreaColumn (Page 228) 


Methods Available in VBS 


Activate 


ActivateDynamic 


DeactivateDynamic 


Export 


GetRow (Page 731) 


GetSelectedRow (Page 738) 


GetStatusbarElement 


GetRowCollection (Page 732) 


GetSelectedRows (Page 739) 


GetStatusbarElementCollection 


GetRulerBlock 


GetStatisticAreaColumn 


GetToolbarButton 


GetRulerBlockCollection 


GetStatisticAreaColumnCollection 


GetToolbarButtonCollection 


GetRulerColumn 


GetStatisticResultColumn 


GetRulerColumnCollection 


GetStatisticResultColumnCollection 


ShowHelp 


ShowPropertyDialog 


Properties Available in VBS 


If you access the properties with the listing object, you do not have to enter the name of the 


listing. For example, when using "rulercolobj.ColumnName", the listing name "Column" is 


dropped: "rulercolobj.Name". 


Note that properties are available for WinCC controls that can have the effect of methods. 


These properties are characterized by the respective names, e.g. "Add", "Remove" or 


"Rename". 


AutoCompleteColumns 


AutoPositon 


AutoSelectionRectColor 


AutoCompleteRows 


AutoSelectionColors 


AutoShow 


BackColor BlockHideText BlockShowDate 
BlockAlign BlockHideTitleText BlockShowlcon 
BlockAutoPrecisions BlockID BlockShowTitlelcon 
BlockCaption BlockIndex BlockTimeFormat 
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BlockCount 


BlockLength 


BlockUseSourceFormat 


BlockDateFormat 


BlockName 


BorderColor 


BlockExponentialFormat 


BlockPrecisions 


BorderWidth 


Caption 


ColumnAdd 


ColumnScrollbar 


CellCut 


ColumnCount 


ColumnSort 


CellSpaceBottom 


ColumnIndex 


ColumnSortIndex 


CellSpaceLeft 


ColumnName 


Column TitleAlign 


CellSpaceRight 


ColumnRemove 


Column Titles 


CellSpaceTop 


ColumnRepos 


ColumnVisible 


Closeable 


ColumnResize 


ExportDirectoryChangeable 


ExportFilenameChangeable 


ExportSelection 


ExportDirectoryname ExportFormatGuid ExportShowDialog 
ExportFileExtension ExportFormatName ExportXML 
ExportFilename ExportParameters 

Font 

GridLineColor GridLineWidth 

HorizontalGridLines 

IconSpace 

LineColor LineWidth 

Moveable 

PrintJobName 


RowCellCount (Page 364) 


RowScrollbar 


RTPersistencePasswordLevel 


RowCellText (Page 366) 


RowTitleAlign 


RTPersistenceType 
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RowCount (Page 394) 


RowTitles 


RulerType 


RowNumber (Page 553) 


RTPersistence 


SelectedCellColor SelectionRect ShowSortlIndex 
SelectedCellForeColor SelectionRectColor ShowTitle 
SelectedRowColor SelectionRectWidth Sizeable 
SelectedRowF oreColor SelectionType SkinName 
SelectedTitleColor ShareSpaceWithSourceControl SortSequence 
SelectedTitleForeColor ShowSortButton SourceControl 
SelectionColoring ShowSortlcon SourceControlType 


StatusbarBackColor StatusbarElementName StatusbarElementVisible 
StatusbarElementAdd StatusbarElementRemove StatusbarElementWidth 
StatusbarElementAutoSize StatusbarElementRename StatusbarFontColor 
StatusbarElementCount StatusbarElementRepos StatusbarShowTooltips 
StatusbarElementlconld StatusbarElementText StatusbarText 
StatusbarElementld StatusbarElementTooltipText StatusbarUseBackColor 
StatusbarElementIndex StatusbarElementUserDefined StatusbarVisible 
TableColor TitleColor TitleGridLineColor 
TableColor2 TitleCut TitleLightShadowColor 
TableForeColor TitleDarkShadowColor TitleSort 
TableForeColor2 TitleForeColor TitleStyle 


ToolbarAlignment 


ToolbarButtonHotKey 


ToolbarButtonRepos 


ToolbarBackColor 


ToolbarButtonld 


ToolbarButtonTooltip Text 


ToolbarButtonActive 


ToolbarButtonIndex 


ToolbarButtonUserDefined 


ToolbarButtonAdd 
ToolbarButtonBeginGroup 


ToolbarButtonLocked 
ToolbarButtonName 


ToolbarButtonVisible 
ToolbarShowTooltips 


ToolbarButtonClick 


ToolbarButtonPasswordLevel 


ToolbarUseBackColor 


ToolbarButtonCount ToolbarButtonRemove ToolbarUseHotKeys 
ToolbarButtonEnabled ToolbarButtonRename ToolbarVisible 
UseSelectedTitleColor UseSourceForeColors UseTableColor2 


UseSourceBackColors 


VerticalGridLines 
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Example 


A WinCC Ruler Control is inserted in a picture with an existing WinCC OnlineTableControl. 
The RulerControl contains a statistics window that displays the "Minimum", "Maximum" and 
"Average" columns. The static values are then displayed for the selected rows of the 
OnlineTableControl. 


Requirement 


@ A"WinCC OnlineTableControl" with the name "Control1" has already been inserted in a 
process picture in Graphics Designer. The control is linked with archive tags or process 
tags. The picture "B_025 V7_Arch_TableControl.PDL" from the demo project was used for 
this example. 


e You have added an additional "WinCC RulerControl" with the name "Control2" in the picture. 


e A button is inserted in the Graphics Designer. You have configured the event "mouse click" 
with a VBS action and the following script for the button. 


e You have selected some rows in OnlineTableControl. 


"VBS364 

Sub OnClick(ByVal Item) 
Dim objRulerControl 
Dim objTableControl 
Dim objstatColumn 

Dim rows 


Set objRulerControl = ScreenItems("Control2") 

' Use Statistic-window 

objRulerControl.RulerType = 2 

objRulerControl.SourceControl = "Controlli" 

' In Statistic-window only columns "Name", "MinValue", MaxValue" and "Average" are shown 
Set objstatColumn = objRulerControl.GetStatisticResultColumnCollection 
objstatColumn.Removeltem (4) 

objstatColumn.RemovelItem (5) 

objstatColumn.Removeltem (6) 

' Get the selected rows of tablecontrol and calculate statistic 

Set objTrendControl = ScreenItems("Controlli") 

Set rows = objTableControl.SelectAll 
objTableControl.CalculateStatistic 


End Sub 
Note 
More examples for use of properties and methods are available in the descriptions of the Get 
methods of the controls and under "Examples for VBScript/Examples in WinCC/Dynamizing 
controls". 

See also 


Controls (Page 218) 
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WinCC Slider Control 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "WinCC Slider Control" 


Type Identifier in VBS 


HMISlider 
Usage 
In the following example, the object with the name "Control1" is moved 19 pixels to the right: 
"VBS 63 
Dim objControl 
Set objControl = ScreenItems ("Controlli") 


objControl.Left = objControl.Left +19 


Notes on Error Handling 


Sliders and WinCC slider controls are mapped in the object model to an "HMlSlider" type. 
Since the objects have different properties, the availability of the property (dynamic type 
compilation in Runtime) should be queried via an exception measure. The exception measure 
is activated for the corresponding procedure by the following instruction: 


On Error Resume Next 


The instruction causes the VBScript engine to initiate the follow-on command in the case of a 
Runtime error. 


The error code can subsequently be checked using the Err object. In order to deactivate the 
handling of Runtime errors in scripts, use the following command: 


On Error Goto 0 
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Handling errors always relates to the procedure layer. If a script in a procedure causes an 
error, VBScript checks whether an error handling measure is implemented in this layer. If not, 
control is transferred one layer up (to the calling procedure). If there is no error handling 
measure here either, the control is transferred yet another layer up. This continues until either 
the top module level is reached or the code for Runtime error handling is located. If the 
activation of the Runtime error handling fails, the control is transferred to the top level on the 
internal VBScript Runtime error handing. This opens an error dialog and stops the script. 


The "On Error Resume Next" command can be installed on all layers (i.e. also in procedures). 
When the error handling measure is use, it can basically be determined whether the user is 
actually using the required implementation type. 


In addition, it can be ensured that there is no termination of execution due to a faulty access 
to the object. 


Examples of error handling 


Sub OnClick(Byval Item) 

'VBS193 

Dim ScreenItem 

" activating error handling: 

On Error Resume Next 

For Each ScreenItem In ScreenItems 


If ScreenItem.Type = "HMISlider" Then 

‘=== Property "BevelColorUp" only exists for a WinCC Slider Control 
ScreenItem.BevelColorUp = 1 

If (Err.Number <> 0) Then 

HMTRuntime.Trace (ScreenItem.ObjectName + ": no Windows-Slider" + vbCrlf) 
" delet rror messag 

Err.Clear 

End If 

‘=== Property "BorderStyle" only exists for a Windows-Slider 
ScreenItem.BorderStyle = 1 

If (Err.Number <> 0) Then 

HMTRuntime.Trace (ScreenItem.ObjectName + ": no WinCC Slider Control" + vbCrlf) 
Err.Clear 

End If 

End If 

Next 

On Error GoTo 0 ' deactivating error handling 

End Sub 
See also 


PictureThumb Property (Page 538) 
BarFillColor Property (Page 329) 
Activate Method (Page 712) 
Properties (Page 301) 
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Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Controls (Page 218) 

WithLabels Property (Page 701) 
WithAxes Property (Page 701) 

Width Property (Page 698) 

Visible Property (Page 696) 

Type Property (Page 666) 

Top Property (Page 643) 

TickStyle Property (Page 602) 
ThumbBackColor Property (Page 599) 
ShowThumb Property (Page 577) 
ShowPosition Property (Page 574) 
ShowBar Property (Page 572) 
RangeMin Property (Page 548) 
RangeMax Property (Page 548) 
Position Property (Page 541) 
PictureBack Property (Page 536) 
Parent Property (Page 529) 
OuterBevelWidth Property (Page 527) 
OuterBevelStyle Property (Page 526) 
ObjectName Property (Page 512) 
Object Property (Page 512) 

LocalelD Property (Page 482) 

Left Property (Page 476) 

Layer Object (Page 120) 

LabelColor Property (Page 457) 
InnerBevelWidth Property (Page 453) 
InnerBevelStyle Property (Page 453) 
InnerBevelOffset Property (Page 453) 
Height Property (Page 443) 
ForeColor Property (Page 435) 
FontPosition Property (Page 433) 
Font property (before WinCC V7) (Page 431) 
FocusWidth Property (Page 430) 
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FocusColor Property (Page 430) 
Enabled Property (Page 408) 
ContinousChange Property (Page 393) 
Caption Property (Page 362) 
BevelColorUp Property (Page 345) 
BevelColorDown Property (Page 344) 
BarBackColor Property (Page 326) 
BackStyle Property (Page 325) 
BackColor Property (Page 322) 


WinCC UserArchiveControl 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "WinCC 


UserArchiveControl" as of WinCC V7.0. 


Type Identifier in VBS 


HM |UserArchiveControl 


Available list objects 


Column (Page 221) 


StatusbarElement (Page 229) 


Row (Page 225) 


ToolbarButton (Page 232) 


Methods Available in VBS 


Activate ActivateDynamic 
CopyRows CutRows 
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Export 


GetColumn 


GetSelectedRow (Page 738) 


GetToolbarButton 


GetColumnCollection 


GetSelectedRows (Page 739) 


GetToolbarButtonCollection 


GetRow (Page 731) 


GetStatusbarElement 


GetRowCollection (Page 732) 


GetStatusbarElementCollection 


MoveToFirst MoveToNext MoveToPrevious 
MoveToLast 

PasteRows Print 

ReadTags 

ServerExport ShowPropertyDialog ShowSelectTimeBase 


Serverlmport 


ShowSelectArchive 


ShowSort 


ShowHelp 


ShowSelection 


WriteTags 


Properties Available in VBS 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. For example, when using "colobj.ColumnName", the listing name "Column" is dropped: 


"colobj.Name". 


Note that properties are available for WinCC controls that can have the effect of methods. 
These properties are characterized by the respective names, e.g. "Add", "Remove" or 


"Rename". 


ArchiveName 


AutoCompleteColumns 


AutoSelectionColors 


ArchiveType 


AutoCompleteRows 


AutoSelectionRectColor 


BackColor 


BorderColor 


BorderWidth 
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Caption 


CellSpaceLeft 


CellSpaceTop 


CellCut 


CellSpaceRight 


Closeable 


CellSpaceBottom 


ColumnAlias 


ColumnLeadingZeros 


ColumnShowlcon 


ColumnAlign 


ColumnLength 


ColumnShowTitlelcon 


ColumnAutoPrecisions 


ColumnMaxValue 


ColumnSort 


ColumnCaption 


ColumnMinValue 


ColumnSortIndex 


ColumnCount 


ColumnName 


ColumnStartValue 


ColumnDateFormat 


ColumnPosition (Page 384) 


ColumnStringLength 


ColumnDMVarName 


ColumnPrecisions 


ColumnTimeFormat 


ColumnExponentialFormat 


ColumnReadAccess 


Column TitleAlign 


ColumnFlagNotNull 


ColumnReadonly 


Column Titles 


ColumnFlagUnique 


ColumnRepos 


ColumnType 


ColumnHideText 


ColumnResize 


ColumnVisible 


ColumnHideTitleText 


ColumnScrollbar 


ColumnWriteAccess 


ColumnIndex 


ColumnShowDate 


EnableDelete 


ExportFileExtension 


ExportParameters 


EnableEdit 


ExportFilename 


ExportSelection 


Enablelnsert ExportFilenameChangeable ExportShowDialog 

ExportDirectoryChangeable ExportFormatGuid ExportXML 

ExportDirectoryname ExportFormatName 

FilterSQL Font 

GridLineColor GridLineWidth 

HorizontalGridLines 

IconSpace 

LineColor LineWidth 
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PrintJobName 


RowCellCount (Page 364) 


RowScrollbar 


RTPersistence 


RowCellText (Page 366) 


RowTitleAlign 


RTPersistencePasswordLevel 


RowCount (Page 394) 


RowTitles 


RTPersistenceType 


RowNumber (Page 553) 


SelectArchiveName 


SelectionColoring 


ShowSortlcon 


SelectedCellColor 


SelectionRect 


ShowSortlndex 


SelectedCellForeColor SelectionRectColor ShowTitle 
SelectedRowColor SelectionRectWidth Sizeable 
SelectedRowF oreColor SelectionType SkinName 
SelectedTitleColor ShowSortButton SortSequence 


SelectedTitleForeColor 


StatusbarBackColor StatusbarElementName StatusbarElementVisible 
StatusbarElementAdd StatusbarElementRemove StatusbarElementWidth 
StatusbarElementAutoSize StatusbarElementRename StatusbarFontColor 
StatusbarElementCount StatusbarElementRepos StatusbarShowTooltips 
StatusbarElementlconld StatusbarElementText StatusbarText 
StatusbarElementld StatusbarElementTooltipText StatusbarUseBackColor 
StatusbarElementIndex StatusbarElementUserDefined StatusbarVisible 
TableColor TitleColor TitleGridLineColor 
TableColor2 TitleCut TitleLightShadowColor 
TableForeColor TitleDarkShadowColor TitleSort 
TableForeColor2 TitleForeColor TitleStyle 

TimeBase 

ToolbarAlignment ToolbarButtonHotKey ToolbarButtonRepos 


ToolbarBackColor 


ToolbarButtonld 


ToolbarButtonTooltipText 


ToolbarButtonActive 


ToolbarButtonIndex 


ToolbarButtonUserDefined 


ToolbarButtonAdd 


ToolbarButtonLocked 


ToolbarButtonVisible 


ToolbarButtonBeginGroup 


ToolbarButtonName 


ToolbarShowTooltips 
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ToolbarButtonClick ToolbarButtonPasswordLevel ToolbarUseBackColor 
ToolbarButtonCount ToolbarButtonRemove ToolbarUseHotKeys 
ToolbarButtonEnabled ToolbarButtonRename ToolbarVisible 
UseSelectedTitleColor UseTableColor2 
VerticalGridLines 
Example 


A user archive is displayed in a WinCC UserArchiveControl. 
The following actions are initiated via script: 

e Selecting data 

e Exporting data 


e Printing a table 


Requirement 


@ A"WinCC UserArchiveControl" with the name "Control1" is inserted in a process picture in 
Graphics Designer. 


e A button is inserted in the Graphics Designer. You have configured the event "mouse click" 
with a VBS action and the following script for the button. 


e You have already configured a user archive in your project. Or you are using the demo 
project from which you can use a user archive. 
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VBS365 

Sub OnClick(ByVal Item) 

Dim objUAControl 

Dim objColumn 

Dim coll 

Dim field 

' create reference to UserArchivControl 

Set objUAControl = ScreenItems ("Controll") 

' Select user archive and general column properties 
objUAControl.SelectArchiveName = True 
objUAControl.ColumnResize = False 
objUAControl.ColumnTitleAlign = 1 

' properties for ID column 

Set objColumn = objUAControl.GetColumn ("ID") 
objColumn.Length = 2 

objColumn.Align = 0 

" Select data 

objUAControl.FilterSQL = "ID >=3" 

"export the content as a CSV-file in the "ua" directory of the project folder 
objUAControl.ServerExport 

' print the control 


objUAControl.PrintJobName = "UserArchiveControl - Table" 
objUAControl.Print 
End Sub 

Note 


More examples for use of properties and methods are available in the descriptions of the Get 
methods of the controls and under "Examples for VBScript/Examples in WinCC/Dynamizing 
controls". 


See also 
Controls (Page 218) 
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Controls before WinCC V7 
WinCC Alarm Control (before WinCC V7) 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "WinCC Alarm Control" 


Type Identifier in VBS 
HMIMessageView 


Usage 


In the following example, the object with the name "Control1" is moved 10 pixels to the right: 


"VBS54 

Dim objControl 

Set objControl = ScreenItems ("Controlli") 
objControl.Left = objControl.Left + 10 


See also 
ProjectPath Property (Page 545) 
BackColor Property (Page 322) 
Activate Method (Page 712) 
Properties (Page 301) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Controls (Page 218) 
WindowType Property (Page 701) 
Width Property (Page 698) 
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Visible Property (Page 696) 

Type Property (Page 666) 

Top Property (Page 643) 

ToolbarButtons Property (Page 638) 

Titleline Property (Page 626) 

TitleCut property (before WinCC V7) (Page 625) 
StatusbarPanes Property (Page 592) 

ServerNames property (before WinCC V7) (Page 571) 
SelectionType property (before WinCC V7) (Page 568) 
SelectionRectWidth property (before WinCC V7) (Page 567) 
SelectionRectColor property (before WinCC V7) (Page 567) 
SelectionMode Property (Page 566) 
PersistentRTPermission Property (Page 533) 
PersistentRT CSPermission Property (Page 533) 
Parent Property (Page 529) 

ObjectName Property (Page 512) 

Object Property (Page 512) 

MsgFilterSQL property (before WinCC V7) (Page 508) 
MsgCtrlFlags Property (Page 508) 

LineTitle Property (Page 481) 

LineHeight Property (Page 480) 

LineFont Property (Page 480) 

Left Property (Page 476) 

Layer Object (Page 120) 

Height Property (Page 443) 

HeaderSort Property (Page 443) 

GridLineVert Property (Page 442) 

GridLineHorz Property (Page 440) 

Font property (before WinCC V7) (Page 431) 

Enabled Property (Page 408) 

ColWidth Property (Page 389) 

ColTitle Property (Page 378) 

ColMove Property (Page 374) 

CellCut property (before WinCC V7) (Page 364) 
Caption Property (Page 362) 
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ButtonCommand Property (Page 358) 

AutoScroll property (before WinCC V7) (Page 317) 

AllServer property (before WinCC V7) (Page 311) 

Activate property (before WinCC V7) (Page 302) 
LocaleSpecificSettings Property (Page 483) 

SortOrder Property (Page 580) 

TableFocusOnButtonCommand Property (Page 595) 

CursorMode Property (Page 396) 

CursorModePrefetch Property (Page 396) 
LongTimeArchiveConsistency property (before WinCC V7) (Page 486) 


WinCC Function Trend Control (before WinCC V7) 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "WinCC Function Trend 
Control" 


Type Identifier in VBS 
HM |FunctionTrendView 


Usage 
In the following example, the object with the name "Control1" is moved 13 pixels to the right: 
'VBS57 
Dim objControl 
Set objControl = ScreenItems ("Controlli") 


objControl.Left = objControl.Left +13 
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See also 
Top Property (Page 643) 
ScalingTypeY Property (Page 560) 
Layer Object (Page 120) 
DesiredCurveSourceUAArchive Property (Page 403) 
Activate Method (Page 712) 
Properties (Page 301) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Controls (Page 218) 
Width Property (Page 698) 
Visible Property (Page 696) 
UpperLimitValue Property (Page 674) 
UpperLimit Property (Page 673) 
UpperLimitColor Property (Page 674) 
Type Property (Page 666) 
ToolbarHotKeys Property (Page 640) 
ToolbarButtons Property (Page 638) 
ToolbarAlignment property (before WinCC V7) (Page 629) 
Titleline Property (Page 626) 
TimeZone Property (Page 624) 
TimeAxisX Property (Page 609) 
TagProviderClsid Property (Page 597) 
SourceUAColumnY Property (Page 586) 
SourceUAColumnX Property (Page 586) 
SourceUAArchiveStartID Property (Page 585) 
SourceUAArchive Property (Page 585) 
SourceTimeRange Property (Page 585) 
SourceTagProviderDataY Property (Page 584) 
SourceTagProviderDataX Property (Page 584) 
SourceTagNameyY Property (Page 584) 
SourceTagNamexX Property (Page 583) 
SourceNumberOfValues Property (Page 583) 
SourceNumberOfUAValues Property (Page 582) 
SourceEndTime Property (Page 582) 
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SourceBeginTime Property (Page 581) 
ShowValuesExponentialY Property (Page 578) 
ShowValuesExponentialX Property (Page 578) 
ShowRulerlmmediately Property (Page 575) 
ScalingTypeX Property (Page 559) 
RulerPrecisionY Property (Page 556) 
RulerPrecisionX Property (Page 556) 
Replacement Property (Page 550) 
ReplacementColor Property (Page 551) 
RelayCurves Property (Page 550) 
ProviderType Property (Page 545) 

PrecisionY Property (Page 542) 

PrecisionX Property (Page 542) 
PersistentRTPermission Property (Page 533) 
PersistentRT Property (Page 532) 
PersistentRTCSPermission Property (Page 533) 
PersistentRTCS Property (Page 532) 

Parent Property (Page 529) 

Online property (before WinCC V7) (Page 516) 
ObjectName Property (Page 512) 

Object Property (Page 512) 

Numltems Property (Page 511) 

Name Property (Page 509) 

LowerLimitValue Property (Page 487) 
LowerLimit Property (Page 486) 
LowerLimitColor Property (Page 487) 
LoadDatalmmediately property (before WinCC V7) (Page 482) 
Left Property (Page 476) 

LabelY Property (Page 458) 

LabelX Property (Page 457) 

ItemVisible Property (Page 456) 

InsertData Property (Page 454) 

Index Property (Page 452) 

Height Property (Page 443) 

GridlinesY Property (Page 441) 
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GridlinesX Property (Page 441) 

GridlinesValueY Property (Page 441) 

GridlinesValueX Property (Page 440) 

GraphDirection property (before WinCC V7) (Page 439) 
FreezeProviderConnections Property (Page 438) 

Font property (before WinCC V7) (Page 431) 
FineGridY Property (Page 423) 

FineGridX Property (Page 423) 

FineGridValueY Property (Page 423) 

FineGridValueX Property (Page 422) 

EndY Property (Page 411) 

EndxX Property (Page 411) 

Enabled Property (Page 408) 

DesiredCurveVisible Property (Page 405) 
DesiredCurveSourceUAColumnY Property (Page 404) 
DesiredCurveSourceUAColumnX Property (Page 404) 
DesiredCurveSourceUAArchiveStartID Property (Page 404) 
DesiredCurveSourceNumberOfUAValues Property (Page 403) 
DesiredCurveCurveForm Property (Page 403) 
DesiredCurveColor Property (Page 402) 

DeleteData Property (Page 402) 

DataY Property (Page 400) 

DataXY Property (Page 399) 

DataX Property (Page 399) 

Datalndex Property (Page 398) 

CurveForm Property (Page 396) 

CommonyY Property (Page 391) 

Commonx Property (Page 391) 

Color Property (Page 374) 

CoarseGridY Property (Page 372) 

CoarseGridX Property (Page 372) 

CoarseGridValueY Property (Page 373) 
CoarseGridValueX Property (Page 373) 

Closeable property (before WinCC V7) (Page 370) 
Caption Property (Page 362) 
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BeginY Property (Page 344) 

BeginX Property (Page 344) 

BackColor Property (Page 322) 
AutorangeY Property (Page 317) 
AutorangeX Property (Page 317) 
AllowPersistence Property (Page 310) 
LocaleSpecificSettings Property (Page 483) 
PrintBackgroundColor Property (Page 543) 
PrintJob Property (Page 544) 

RulerFont Property (Page 556) 


WinCC Online Table Control (before WinCC V7) 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "WinCC Online Table 


Control" 


Type Identifier in VBS 


Usage 


"VBS59 
Dim objControl 
Set objControl 


HMITableView 


In the following example, the object with the name "Control1" is moved 15 pixels to the right: 


= ScreenItems ("Controll") 


objControl.Left = objControl.Left +15 
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See also 
TimeOverlap Property (Page 620) 
ItemVisible Property (Page 456) 
PrintBackgroundColor Property (Page 543) 
Activate Method (Page 712) 
Properties (Page 301) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Controls (Page 218) 
Width Property (Page 698) 
Visible Property (Page 696) 
Variable Property (Page 695) 
ValueColumnAlignment Property (Page 688) 
UpperLimitValue Property (Page 674) 
UpperLimit Property (Page 673) 
UpperLimitColor Property (Page 674) 
Type Property (Page 666) 
Top Property (Page 643) 
ToolbarHotKeys Property (Page 640) 
Toolbar Property (Page 628) 
ToolbarButtons Property (Page 638) 
ToolbarAlignment property (before WinCC V7) (Page 629) 
Titleline Property (Page 626) 
TimeZone Property (Page 624) 
TimeRangeFactor Property (Page 622) 
TimeRange Property (Page 621) 
TimeRangeBase Property (Page 621) 
TimeOverlapColor Property (Page 620) 
TimeJump Property (Page 619) 
TimeJumpColor Property (Page 620) 
TimeFormat Property (Page 619) 
TimeColumnAlignment Property (Page 611) 
Statusbar Property (Page 588) 
PrintJob Property (Page 544) 
Precisions Property (Page 542) 
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PersistentRTPermission Property (Page 533) 
PersistentRT Property (Page 532) 

PersistentRT CSPermission Property (Page 533) 
PersistentRTCS Property (Page 532) 

Parent Property (Page 529) 

Online property (before WinCC V7) (Page 516) 
ObjectName Property (Page 512) 

Object Property (Page 512) 

Numltems Property (Page 511) 
LowerLimitValue Property (Page 487) 
LowerLimit Property (Page 486) 
LowerLimitColor Property (Page 487) 
LoadDatalmmediately property (before WinCC V7) (Page 482) 
Left Property (Page 476) 

Layer Object (Page 120) 

Index Property (Page 452) 

Height Property (Page 443) 

Font property (before WinCC V7) (Page 431) 
EndTime Property (Page 410) 

Enabled Property (Page 408) 

Edit Property (Page 407) 

Editable Property (Page 407) 

CommontTime Property (Page 390) 

Command Property (Page 390) 

Color Property (Page 374) 

Closeable property (before WinCC V7) (Page 370) 
Caption Property (Page 362) 

BeginTime Property (Page 343) 

BackColor Property (Page 322) 

Archive Property (Page 314) 

AllowPersistence Property (Page 310) 

Actualize Property (Page 305) 

Activate property (before WinCC V7) (Page 302) 
LocaleSpecificSettings Property (Page 483) 
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WinCC Online Trend Control (before WinCC V7) 


Description 


Screens 
Screen 


Screenltems 
Screenltem 


Object Type of Screenltem Object. Represents the graphic object "WinCC Online Trend 
Control" 


Type Identifier in VBS 
HMITrendView 


Usage 
In the following example, the object with the name "Control1" is moved 16 pixels to the right: 
"VBS 60 
Dim objControl 
Set objControl = ScreenItems ("Controll") 


objControl.Left = objControl.Left +16 


See also 
Properties (Page 301) 
TimeAxis Property (Page 602) 
LowerLimitColor Property (Page 487) 
Caption Property (Page 362) 
Activate Method (Page 712) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Controls (Page 218) 
Width Property (Page 698) 
Visible Property (Page 696) 
UpperLimitValue Property (Page 674) 
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UpperLimit Property (Page 673) 
UpperLimitColor Property (Page 674) 

Type Property (Page 666) 

Top Property (Page 643) 

ToolbarHotKeys Property (Page 640) 
Toolbar Property (Page 628) 

ToolbarButtons Property (Page 638) 
ToolbarAlignment property (before WinCC V7) (Page 629) 
Titleline Property (Page 626) 

TimeZone Property (Page 624) 
TimeRangeFactor Property (Page 622) 
TimeRange Property (Page 621) 
TimeRangeBase Property (Page 621) 
TimeOverlap Property (Page 620) 
TimeOverlapColor Property (Page 620) 
TimeJump Property (Page 619) 
TimeJumpColor Property (Page 620) 
TimeAxisFormat Property (Page 605) 
TagName Property (Page 596) 

Statusbar Property (Page 588) 
ShowRulerlmmediately Property (Page 575) 
ServerData Property (Page 569) 
RulerPrecisions Property (Page 556) 
Replacement Property (Page 550) 
ReplacementColor Property (Page 551) 
RelayCurves Property (Page 550) 
ProviderClsid Property (Page 545) 

PrintJob Property (Page 544) 

Precisions Property (Page 542) 
PersistentRTPermission Property (Page 533) 
PersistentRT Property (Page 532) 
PersistentRTCSPermission Property (Page 533) 
PersistentRTCS Property (Page 532) 

Parent Property (Page 529) 

Online property (before WinCC V7) (Page 516) 
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ObjectName Property (Page 512) 

Object Property (Page 512) 

Numltems Property (Page 511) 
MeasurePoints Property (Page 494) 
LowerLimitValue Property (Page 487) 
LowerLimit Property (Page 486) 
LoadDatalmmediately property (before WinCC V7) (Page 482) 
Left Property (Page 476) 

Layer Object (Page 120) 

Label Property (Page 457) 

ItemVisible Property (Page 456) 

Index Property (Page 452) 

Height Property (Page 443) 

GridLineValue Property (Page 442) 
GridLines Property (Page 440) 
GraphDirection property (before WinCC V7) (Page 439) 
Font property (before WinCC V7) (Page 431) 
FineGridValue Property (Page 422) 

FineGrid Property (Page 422) 

EndValue Property (Page 410) 

EndTime Property (Page 410) 

Enabled Property (Page 408) 

CurveForm Property (Page 396) 

CommonyY Property (Page 391) 

Commonx Property (Page 391) 

Command Property (Page 390) 

Color Property (Page 374) 

CoarseGridValue Property (Page 372) 
CoarseGrid Property (Page 371) 

Closeable property (before WinCC V7) (Page 370) 
BeginValue Property (Page 343) 

BeginTime Property (Page 343) 

BackColor Property (Page 322) 

Autorange Property (Page 317) 
AllowPersistence Property (Page 310) 
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Actualize Property (Page 305) 

Activate property (before WinCC V7) (Page 302) 
AdjustRuler Property (Page 307) 

LineWidth property (before WinCC V7) (Page 481) 
ScalingType Property (Page 558) 
UseRangeSubstitutes Property (Page 676) 
XAxisColor property (before WinCC V7) (Page 702) 
HideTagNames Property (Page 445) 
LocaleSpecificSettings Property (Page 483) 
PrintBackgroundColor Property (Page 543) 
ItemProviderClsid Property (Page 456) 

OneY Property (Page 516) 

AllowXAxisColor - Property (Page 311) 
AnchorRuler Property (Page 312) 

SavedTrend Property (Page 557) 

SelectedTrend Property (Page 565) 
ShowSpanNames Property (Page 577) 
DefaultPrecision Property (Page 400) 
DefaultRulerPrecision Property (Page 400) 
LowerLimitTagName Property (Page 487) 
UpperLimitTagName Property (Page 674) 
UseOnlineTags Property (Page 676) 


1.14.3.7 Customized Object 


Description 


Screens 


Screenltems 


Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Customized Object". 
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Type Identifier in VBS 
HM IScreenModule 


Usage 


You access customized properties in a customized object via the attribute name in VBS. 
Intellisense is only applicable to the customized object as a whole. 


You will locate the attribute name under Properties of the properties placed outside (right-click 
Property) and can be modified there. 


In the following example, the object with the name "CustomizedObject1" is moved 10 pixels 
to the right: 


"VBS65 

Dim objCustomObject 

Set objCustomObject = ScreenItems ("CustomizedObject1") 
objCustomObject.Left = objCustomObject.Left + 10 


See also 
Activate Method (Page 712) 
Properties (Page 301) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Object types of the Screenltem object (Page 143) 
Width Property (Page 698) 
Visible Property (Page 696) 
Type Property (Page 666) 
Top Property (Page 643) 
ToolTipText Property (Page 641) 
Parent Property (Page 529) 
ObjectName Property (Page 512) 
Left Property (Page 476) 
Layer Object (Page 120) 
Height Property (Page 443) 
Enabled Property (Page 408) 
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1.14.3.8 Group 


Description 


Screens 


Screen 


Screenltems 


Screenltem 


Object Type of Screenltem Object. Represents the graphic object "Group" 


Type Identifier in VBS 
HMIGroup 


Usage 
In the following example, the object with the name "Group1" is moved 10 pixels to the right: 


"VBS 66 

Dim objGroup 

Set objGroup = ScreenItems ("Group1") 
objGroup.Left = objGroup.Left + 10 


See also 
Properties (Page 301) 
Activate Method (Page 712) 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Object types of the Screenltem object (Page 143) 
Width Property (Page 698) 
Visible Property (Page 696) 
Type Property (Page 666) 
Top Property (Page 643) 
ToolTipText Property (Page 641) 
Parent Property (Page 529) 
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ObjectName Property (Page 512) 
Left Property (Page 476) 

Layer Object (Page 120) 

Height Property (Page 443) 
Enabled Property (Page 408) 


1.14.4 Properties 
1.14.4.1 Properties 
Overview 


The properties of the individual objects can be used to modify specific graphic objects and 
tags in Runtime , e.g. activating an operating element per mouse click or triggering a color 
change by modifying a tag value. 


Properties on graphic objects can be addressed via the following syntax: 


"VBS191 

Dim obj 

Set obj = ScreenItems("objectl") 
obj.property = Value 


In the following example, the object with the name "Control1" is moved 10 pixels to the right: 


"'VBS192 

Dim obj 

Set obj = ScreenItems ("controll") 
obj.Left = obj.Left + 10 
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1.14.4.2 A 
Aa - Ad 
AccessPath Property 


Description 
Displays the storage path (with hierarchy information) of a screen object (picture). The property 
corresponds to the full access code on the Screens Collections. 


STRING (read only) 


Example: 
In the following example, the path of the picture "ScreenWindow1" is issued: 


"VBS67 
Dim objScreen 
Set objScreen = HMTRuntime.Screens ("ScreenWindowl1") 


MsgBox objScreen.AccessPath 


See also 
Screenltem Object (Page 125) 


Screens Object (List) (Page 134) 
Activate property (before WinCC V7) 


Description 


The data to be displayed is only requested from the archive server when this attribute is set. 
In order to reduce the picture opening times, this attribute should not be set and the value only 
dynamically changed when necessary. 


Write/Read access 


To differentiate between the "Activate" property form the "Activate" method, the property is 
accessed via "Object". 
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Example: 
Dim ctrl 
Set ctrl = ScreenItems ("Control") 
ctrl.Object.activate = true 
See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 
Activate property 
Activate 
The data to be displayed in the message window are only requested from the message server 
if you set this attribute. Instead of setting this attribute, it is advisable to change the value 
dynamically in order to reduce picture activation times. 
To differentiate the "Activate" property from the "Activate" method, the property is addressed 
via "Object". 
Example 
Dim ctrlSet 
ctrl = ScreenItems ("Control") 
ctrl.Object.activate = true 
The attribute can be assigned dynamic properties by means of the name Activate . The data 
type is BOOLEAN. 
ActiveProject Property 
Description 
Returns an object of type "Project". 
See also 


Path Property (Page 531) 
Name Property (Page 509) 
Ellipse segment (Page 147) 

HM IRuntime Object (Page 118) 
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ActiveScreen Property 


Description 
Supplies a reference to the picture which contains the object with the current focus. 

Usage 
"ActiveScreen" is used in Runtime to address the properties of the picture which contains the 
currently focussed object. 

Example: 
The following example assigns the name of the current picture to the tag "strScrName" and 
outputs it in a message: 

'VBS68 


Dim strScrName 
strScrName = HMIRuntime.ActiveScreen.Objectnam 


MsgBox strScrName 


See also 
Screen Object (Page 131) 


HM IRuntime Object (Page 118) 


ActiveScreenltem Property 


Description 
Supplies a reference to the object currently in focus. 


Usage 
"ActiveScreenltem" is used in Runtime in order to address the properties of the object currently 
in focus. 
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Example: 
The following example displays the name of the object in the "ScreenWindow1" picture which 
has the focus: 


"VBS69 

Dim objScreen 

Set objScreen = HMTRuntime.Screens ("ScreenWindowl1") 
MsgBox objScreen.ActiveScreenItem. ObjectNam 


See also 
Screenltem Object (Page 125) 


HM IRuntime Object (Page 118) 


Actualize Property 


Description 
The "Index" property references a column pair or a trend. "Actualize" defines whether a static 
or dynamic representation should be used for this column pair/trend. 
@ 0: Static display 
e -1: Dynamic display 

See also 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 

ActualPointLeft Property 

Description 


Defines or returns the x-coordinate of the current corner point in relation to the original picture 
(top left). Each corner point is identified by an index which is derived from the number 
("PointCount") of corner point available. 


A change of the value can affect the properties "Width" (object width) and "Left" (x-coordinate 
of the object position). 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 305 


VBS for Creating Procedures and Actions 


7.14 VBS Reference 


See also 


Polyline (Page 158) 
Polygon (Page 156) 
Screenltem Object (Page 125) 


ActualPointTop Property 


Description 


See also 


Defines or returns the y-coordinate of the current corner point in relation to the original picture 
(top left). Each corner point is identified by an index which is derived from the number 
("PointCount") of corner point available. 


Achange of the value can affect the properties "Height" (object height) and "Top" (y-coordinate 
of the position). 


Polyline (Page 158) 
Polygon (Page 156) 
Screenltem Object (Page 125) 


AdaptBorder Property 


Description 


See also 


306 


TRUE, when the border should be dynamically adjusted to the size of the text. BOOLEAN write- 
read access. 


For text list and I/O field: Read only access. 


Button (Page 201) 

Static text (Page 165) 

Text list (Page 196) 

Radio box (Page 207) 

Check box (Page 204) 

I/O Field (Page 184) 
Screenltem Object (Page 125) 
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AdaptPicture Property 


Description 


Defines whether the picture displayed in a picture window should be adapted to the size of the 
picture window in Runtime or not. Read only access. 


TRUE, when the picture adapts to the picture window size. 


FALSE, when the picture does not adapt to the picture window size. 


See also 
Picture Window (Page 179) 
Screenltem Object (Page 125) 
AdaptSize Property 
Description 
Defines whether the picture window should adapt to the size of the picture displayed in it during 
Runtime or not. Read only access. 
TRUE, when the picture window adapts to the picture size. 
FALSE, when the picture window does not adapt to the picture size. 
See also 
Picture Window (Page 179) 
Screenltem Object (Page 125) 
AdjustRuler Property 
Description 
Specifies if the ruler window should be adjusted to the trend window upon each appearance. 
TRUE, if you move the ruler window and make it appear and disappear again, it will be 
displayed in its original position and its original size. 
See also 


WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 
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Al- Ap 


AlarmID property 


Description 


Returns the AlarmID of the Alarm object. The AlarmID is unique, and is assigned by the system. 


AlarmID (readonly) 


See also 
Alarms object (list) (Page 110) 


AlarmHigh Property 


Description 


Defines the top limit value at which an alarm should be triggered or returned. 
The type of the evaluation (in percent or absolute) is defined in the "TypeAlarmHigh" property. 
The "CheckAlarmHigh" property determines whether the monitoring for this limit value is 


activated. 


See also 
Bar (Page 174) 
Screenltem Object (Page 125) 


AlarmLogs Property 


Description 


Returns an object of type "AlarmLogs". 


AlarmLogs (read-only) 


See also 
HM IRuntime Object (Page 118) 
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AlarmLow Property 


Description 


See also 


Defines the bottom limit value at which an alarm should be triggered or returned. 

The type of the evaluation (in percent or absolute) is defined in the "TypeAlarmLow" property. 
The "CheckAlarmLow" property determines whether the monitoring for this limit value is 
activated. 


Bar (Page 174) 
Screenltem Object (Page 125) 


Alignment Property 


Description 


See also 


Defines or returns the representation of the scale (left/right or top/bottom) according to the 
position of the bar graph object. The "Scaling" property must be set to TRUE for the scale to 
be displayed. 


Bar (Page 174) 
Screenltem Object (Page 125) 


AlignmentLeft Property 


Description 


See also 


Defines or returns the horizontal alignment of the text. Value range from 0 to 2. 
0 = left 

1 = centered 

2 = right 


Group Display (Page 194) 
Static text (Page 165) 
Text list (Page 196) 
Radio box (Page 207) 
Check box (Page 204) 
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Button (Page 201) 
I/O Field (Page 184) 
Screenltem Object (Page 125) 


AlignmentTop Property 


Description 
Defines or returns the vertical alignment of the text. Value range from 0 to 2. 
0 = top 
1 = centered 
2 = bottom 
See also 


Group Display (Page 194) 
Static text (Page 165) 

Text list (Page 196) 

Radio box (Page 207) 

Check box (Page 204) 

Button (Page 201) 

I/O Field (Page 184) 
Screenltem Object (Page 125) 


AllowPersistence Property 


Description 
TRUE, when settings regarding persistence are possible. BOOLEAN write-read access. 


See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
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AllowXAxisColor - Property 


Description 


TRUE if the defined color of the common X-axis is displayed in runtime. BOOLEAN write-read 
access. 


AllServer property (before WinCC V7) 


Description 


Defines that the data to be displayed in the message window is required by all servers 
participating in a distributed system on which Alarm Logging is activated. Write/Read access. 


See also 
WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 


AllServer property 


All servers - AllServer 


Selects all servers whose packages were loaded and on which "Alarm Logging Runtime" is 
activated in the startup list. 


Value Explanation 
TRUE All servers are activated. 
FALSE Activates only the servers entered in "Server selection". 


The attribute can be assigned dynamic properties by means of the name AllServer. The data 
type is BOOLEAN. 


Analog Property 


Description 


TRUE, when the clock is to be displayed as an analog clock. BOOLEAN write-read access. 


See also 
WinCC Digital/Analog Clock (Page 246) 
Screenltem Object (Page 125) 
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AnchorRuler Property 


Description 
TRUE if the ruler window is firmly linked to the curve window. BOOLEAN write-read access. 


AngleAlpha Property 


Description 


Defines or returns depth angle a for the 3D-effect of the "3DBarGraph" object. Value range in 
degrees from 0 to 90. 


See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 
AngleBeta Property 
Description 
Defines or returns depth angle b for the 3D-effect of the "3DBarGraph" object. Value range in 
degrees from 0 to 90. 
See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 
AngleMax Property 
Description 


Defines or returns the angle on the scale at which the scale graduation ends. LONG write-read 
access. 


The start and end of the scale graduation are described by the attributes "AngleMin" and 
"AngleMax" in angular degrees. AngleMin < AngleMax applies. 


Angle 0 degrees is at the right side of the horizontal diameter of the graduated scale disk. 
Positive angle values are counted in a counterclockwise direction. 
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WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 


AngleMin Property 


Description 


See also 


Defines or returns the angle on the scale at which the scale graduation begins. LONG write- 
read access. 


WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 


Application Property 


Description 


See also 


Returns the Graphics Designer application when the application property is used without an 
object identifier. If the application property is used with object identifier, it returns an application 
object which displays the application with which the defined object was created. Read only 
access. 


Application Window (Page 173) 
Screenltem Object (Page 125) 


ApplyProjectSettings property 


Apply project settings - ApplyProjectSettings 


Activates the project settings derived from "Alarm Logging". 


Value Explanation 

TRUE The "Apply project settings" check box is selected. The message blocks configured in "Alarm Logging" 
and their properties are activated in AlarmControl. The message blocks are displayed with these prop- 
erties in the message window. 

FALSE The "Apply project settings" check box is deactivated. You can add or remove message blocks, or edit 
their properties. 


The attribute can be assigned dynamic properties by means of the name 
ApplyProjectSettings. The data type is BOOLEAN. 
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Ar - Ax 

Archive Property 

Description 
The "Index" property references a pair of columns. "Archive" defines process archive values 
linked to the column pair. The name of the process value archive is specified in the following 
form: Server name::Archive name 

See also 
WinCC Online Table Control (before WinCC V7) (Page 292) 
Screenltem Object (Page 125) 

ArchiveName property 


Name - ArchiveName 


Specifies the user archive or view to be displayed. Open the "Package Browser" dialog for 
configuring an archive or a view by clicking the button. 


The attribute can be assigned dynamic properties by means of the name ArchiveName. The 
data type is STRING. 


ArchiveType property 


Type - ArchiveType 
Specifies whether the selected user archive is an archive or a view. The field cannot be edited. 


The attribute can be assigned dynamic properties by means of the name ArchiveType. The 
data type is LONG. 


AspectRatio property 


AspectRatio 
Specifies if the aspect ratio is kept in movies. 


The attribute can be assigned dynamic properties by means of the name AspectRatio. The 
data type is BOOLEAN. 
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Assignments Property 


Description 
A list which contains the assignments between the output values and the actual output texts 
to be output. 
The assignments depend on the set list type. The list type is defined with the ListType property. 
Read only access. 

See also 
Text list (Page 196) 
Screenltem Object (Page 125) 

AssumeOnExit Property 

Description 
TRUE, if the entered text is assumed upon exiting the entry field (e.g., with the key or mouse 
click). BOOLEAN write-read access. 

See also 


I/O Field (Page 184) 
Text list (Page 196) 
Screenltem Object (Page 125) 


AssumeOnFull Property 


Description 


See also 


TRUE, when the content of the input field is full (specified number of characters have been 
entered) and should be exited automatically and the input accepted. BOOLEAN write-read 
access. 


I/O Field (Page 184) 
Screenltem Object (Page 125) 
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AutoCompleteColumns property 


Show empty columns - AutoCompleteColumns 


Adds empty columns if the Control width is greater than the width of columns configured. 


Value Explanation 
TRUE Enables the display of empty columns. 
FALSE Disables the display of empty columns. 


The attribute can be assigned dynamic properties by means of the name 
AutoCompleteColumns. The data type is BOOLEAN. 


AutoCompleteRows property 


Show empty rows - AutoCompleteRows 


Enables the insertion of empty rows if the Control length is greater than the number of rows 


configured. 
Value Explanation 
TRUE Enables the display of empty rows. 
FALSE Disables the display of empty rows. 


The attribute can be assigned dynamic properties by means of the name 
AutoCompleteRows. The data type is BOOLEAN. 


AutoPosition property 


Automatic positioning - AutoPosition 


Defines whether to position the RulerControl exactly below the source control. 


The following settings are available: 


Value Explanation 
TRUE The RulerControl is positioned exactly below the source control. 
FALSE The RulerControl is displayed in accordance with your configuration of the control position. 
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Autorange Property 


Description 


TRUE, when the value range of the Y-axis is determined automatically or defined by using the 
"BeginValue" and "EndValue"attributes. BOOLEAN write-read access. 


See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 
AutorangeX Property 
Description 
TRUE, when the value range of the X-axis is determined automatically. FALSE, when it is 
determined by means of the "BeginX" and "EndX" attributes. BOOLEAN write-read access. 
See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
AutorangeY Property 
Description 
TRUE, when the value range of the Y-axis is determined automatically. FALSE, when it is 
determined by means of the "BeginY" and "EndY" attributes. BOOLEAN write-read access. 
See also 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


AutoScroll property (before WinCC V7) 


Description 


Defines the behavior of the message window when a new message is received. BOOLEAN 
write-read access. 


TRUE : A newly received message is appended to the list displayed in the message window 
and is automatically selected. The visible range of the message window is moved, if necessary. 
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See also 


FALSE : A newly received message is not selected. The visible range of the message window 
is not changed. 


The targeted selection of messages is only possible when "AutoScroll" is not active. 


The "AutoScroll" property is deactivated when the attribute "MsgCtrIFlag" = "-1" is set. This 
means that the most recent message is displayed at the top of the list in the message window. 


WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 


AutoScroll Property 


Auto scrolling - AutoScroll 


Defines the behavior of the message window after a new message events. 


You can only select message lines if "Auto scrolling" is disabled. 


Explanation 


TRUE If "AutoScroll" is activated, a new activated message is appended to the list displayed in the 
message window and selected automatically. The visible area of the message window is 
shifted as required. 


FALSE | New message events are not selected if "Autoscroll" is disabled. The visible area of the 
message window is not changed. 


The attribute can be assigned dynamic properties by means of the name AutoScroll. The data 
type is BOOLEAN. 


AutoSelectionColors property 


Automatic selection coloring - AutoSelectionColor 


Enables the display of default system colors as selection color for cells and rows. 


Value Explanation 
TRUE The system colors are in use. 
FALSE The custom colors are used. 
The attribute can be assigned dynamic properties by means of the name 
AutoSelectionColors. The data type is BOOLEAN. 
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AutoSelectionRectColor property 


Automatic color assignment - AutoSelectionRectColor 


Defines a system color for the selection border. 


Value Explanation 
TRUE The system color is in use. 
FALSE The custom color is used. 


The attribute can be assigned dynamic properties by means of the name 
AutoSelectionRectColors. The data type is BOOLEAN. 


AutoShow property 


Show/hide automatically - AutoShow 


Enables/disables automatic activation of the RulerControl on the display if you selected the 
button functions for the ruler, statistics range and for statistics in the source control. 


The RulerControl is hidden again if you are no longer using the ruler, statistics range and 
statistics functions. 


Value Explanation 
TRUE The RulerControl is displayed automatically. 
FALSE The RulerControl is not displayed automatically. 


The attribute can be assigned dynamic properties by means of the name AutoShow. The data 
type is BOOLEAN. 


AutoSize Property 


Description 
Defines or returns the size adaptation of the object. The following values can be set: 
e 0: No size adaptation. 
e 1: The picture ("PictureSelected", "PictureUnselected" properties) is adapted to the button. 


@ 2: The button is adapted to the picture ("PictureSelected", "PictureUnselected" properties). 


See also 
WinCC Push Button Control (Page 269) 
Screenltem Object (Page 125) 
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Autostart property 


Autostart 
Specifies if movies are started automatically. 


The attribute can be assigned dynamic properties by means of the name Autostart. The data 
type is BOOLEAN. 


Average Property 


Average 


TRUE, if the mean value is calculated based on the last 10 values. A value change is 
conditional for calculation of a new mean value. The mean value is reset when you change a 
picture. If only one value is available when you change the picture, the following mean value 
is calculated: (6+0+0+0+0+0+0+0+0+0)/10=0,5. 


BOOLEAN write-read access. 


See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
Axe Property 
Description 
Defines or returns the position of the 3D bar in the coordinate system. Value range from 0 to 
2. 
0: The 3D-bar is displayed on the X-axis. 
1: The 3D-bar is displayed on the Y-axis. 
2: The 3D-bar is displayed on the Z-axis. 
See also 


3D Bar (Page 169) 
Screenltem Object (Page 125) 
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AxisSection Property 


Description 
Defines or returns the distance between two long axis sections. The information on the distance 
is given in scale units and is dependent on the minimum and maximum values configured. 
See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
1.14.4.3 B 
Ba 


BackBorderWidth Property 


Description 


Defines or returns the width of the 3D border in pixels. The value for the width is dependent 
on the size of the object. 


See also 
Screenltem Object (Page 125) 
Button (Page 201) 
Round Button (Page 209) 
Slider (Page 212) 
Group Display (Page 194) 


BackColor property 


Background - BackColor 
Specifies the background color of the control. The button opens the "Color selection" dialog. 


The attribute can be assigned dynamic properties by means of the name BackColor. The data 
type is LONG. 
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BackColor property 


Background Color (BackColor) 


Specifies the icon background color in the "Color selection" dialog. The background color is 
displayed in "opaque" style. 


The attribute can be assigned dynamic properties by means of the name BackColor. The data 
type is LONG. 


BackColor Property 


Function 
Defines or returns the background color for the object. 
For objects with a fill pattern, the background color is not displayed if "transparent" is defined 
as the fill style. 
Special features of the WinCC slider control 
The background color only takes effect when the object is at least partially filled. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Enter the appropriate decimal value 
for each of the three RGB values. 


Example: 
RGB(200, 150, 100) 


Example: 
The following example defines the background of the "ScreenWindow1" picture to red: 


"VBS70 

Dim objScreen 

Set objScreen = HMITRuntime.Screens ("ScreenWindowl") 
objScreen.BackColor = RGB(255, 0, O) 


See also 
FillStyle Property (Page 419) 
FillColor Property (Page 418) 
Screenltem Object (Page 125) 
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BackColor2 Property 


Description 
Defines or returns the bar color for the display of the current value. LONG write-read access. 
See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
BackColor3 Property 
Description 
Defines or returns the color of the bar background. LONG write-read access. 
See also 
Screenltem Object (Page 125) 
Bar (Page 174) 
BackColorBottom Property 
Description 
Defines or returns the color for the bottom/right part of the slider. LONG write-read access. 
See also 
Slider (Page 212) 
Screenltem Object (Page 125) 
BackColorTop Property 
Description 
Defines or returns the color for the top/left part of the slider. LONG write-read access. 
See also 


Slider (Page 212) 
Screenltem Object (Page 125) 
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BackFlashColorOff Property 


Description 


Defines or returns the color of the object background for the flash status "Off". LONG write- 
read access. 


See also 
Screenltem Object (Page 125) 


BackFlashColorOn Property 


Description 


Defines or returns the color of the object background for the flash status "On". LONG write- 
read access. 


See also 
Screenltem Object (Page 125) 


Background Property 


Description 


TRUE, when the background of the 3D-bar graph object should be visible. BOOLEAN write- 
read access. 


See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 


BackgroundPicture Property 


Description 


Returns the picture name of the background picture for the graduated scale disk. Read only 
access 
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See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 


BackPictureAlignment property 


Description 
Defines or returns the mode of representation of the background image in the process picture. 
LONG write-read access. 

BackPictureName property 

Description 
Defines the path and file name of the background image in the process picture or returns it. 
LONG write-read access. 

BackStyle Property 

Description 


WinCC Digital/Analog Clock 
Defines the type of background of the analog clock: 
e 0: The rectangular background of the clock is filled by the specified background color. 


@ 1: The round numbered face of the clock is filled by the specified background color. This 
enables a round analog clock to be displayed. 


e 2: Numbered face and rectangular background are transparent. 


WinCC Gauge Control 
Defines the type of background of the gauge: 


e@ 0: The rectangular or square background of the gauge has a border color is filled with the 
specified color. The circular graduated scale disk is filled by the specified background color. 


e@ 1: The rectangular or square background of the gauge is transparent. The circular 
graduated scale disk is filled by the specified background color. This enables a circular 
gauge to be displayed. 


@ 2: The rectangular or square background and graduated scale disk are transparent. 
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WinCC Slider Control 
Defines whether the object background should be transparent. 
@ 0: The object background is not transparent 


e 1: The object background is transparent 


HMI Symbol Library 
Defines the icon background transparency. Write/Read access. 
e 0: The background is transparent and, thus, invisible. 


e 1: The background is visible, the color of the background is defined by the "Background 
Color" attribute. 


See also 
HMI Symbol Library (Page 239) 
WinCC Slider Control (Page 277) 
WinCC Gauge Control (Page 254) 
WinCC Digital/Analog Clock (Page 246) 
Screenltem Object (Page 125) 

Bar 


BarAdd property 


New - BarAdd 
Creates a new diagram. 
The attribute can be assigned dynamic properties using the name BarAdd. The data type is 
STRING. 

BarBackColor Property 

Description 
Defines the background color in the area of the slider. The area stretches form "RangeMin" to 
"RangeMax". 

See also 


WinCC Slider Control (Page 277) 
Screenltem Object (Page 125) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
326 System Manual, 02/2016, A5E37536061-AA 


VBS for Creating Procedures and Actions 


7.14 VBS Reference 


BarBarGradientColor property 


Fill pattern color - BarBarGradientColor 


The "Fill Pattern Color" attribute defines the color of the pattern that is displayed on a filled 
area. 


The attribute can be assigned dynamic properties using the name BarBarGradientColor. The 
data type is LONG. 


BarBarGradientPattern property 


Fill pattern - BarBarGradientPattern 


The "Fill Pattern" attribute specifies the pattern for the display of bars. 


So that the fill pattern becomes visible, the color of the fill pattern must differ from the 
background color. 


49 fill patterns are available for selection: 
e Fill pattern 1 "Solid" fills the object with the set background color. 
e Fill pattern 2 "Transparent" means neither a background nor a fill pattern is displayed. 


The attribute can be assigned dynamic properties using the name BarBarGradientPattern. The 
data type is LONG. 


BarBarWindow property 


Diagram window - BarBarWindow 


Specifies the diagram window in which the selected diagram will be displayed. You specify the 
available diagram windows on the "Diagram window" tab. 


The attribute can be assigned dynamic properties using the name BarWindow. The data type 
is STRING. 


BarChartType property 


Diagram type - BarChartType 


Specifies how the diagram will be displayed. 


The following settings are available: 


Value Description Explanation 

0 Bar diagram A diagram with bars will be displayed. 

1 Bars with value In addition to the bars, the values will be displayed in the diagram. The display of values 
conforms to the configuration of the "Alignment" property and the write direction of the bars. 
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The attribute can be assigned dynamic properties using the name BarChartType. The data 
type is LONG. 


BarColor property 


Border color - BarColor 


Indicates the border color of the bar. Use the button to open the "Color selection" dialog to 
select the color. 


The attribute can be assigned dynamic properties using the name BarColor. The data type is 
LONG. 


BarCount property 


BarCount 
Specifies the number of configured diagrams. 


The attribute can be assigned dynamic properties using the name BarCount. The data type is 
LONG. 


BarDepth Property 


Description 
Defines or returns the depth of the bar in pixels. 


See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 


BarFillColor property 


Bar color - BarFillColor 


Indicates the fill color of the bars. For the "Bars with value" diagram type, the text background 
color is specified. 


Use the button to open the "Color selection" dialog to select the color. 


The attribute can be assigned dynamic properties using the name BarFillColor. The data type 
is LONG. 
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BarFillColor Property 


Description 
Defines the fill color in the area of the slider. The area stretches from "RangeMin" to the position 
of the slider. 
See also 
WinCC Slider Control (Page 277) 
Screenltem Object (Page 125) 
BarHeight Property 
Description 
Defines or returns the height of the bar in pixels. 
See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 
Barlndex property 
Barlndex 


References a configured diagram. Using this attribute, you can assign the values of other 
attributes to a specific diagram. The index must always be set before you change the properties 
of a diagram in Runtime. 


Valid values for "Barlndex" are between 0 and "BarCount" minus 1. The "BarCount" attribute 
specifies the number of configured diagrams. 


The "Barlndex" attribute can be assigned dynamic properties using the attribute BarRepos. 
The data type is LONG. 


BarLabel property 


Label - BarLabel 


Specifies the label of the selected diagram. The label is displayed in Runtime when the 
"UseBarNameAsLabel" attribute has the value "FALSE". 


The attribute can be assigned dynamic properties using the name BarLabel. The data type is 
STRING. 
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BarLineStyle property 


Border style - BarLineStyle 
Specifies which border type is used to represent the border of the bar. 


The following settings are available: 


Value Description Explanation 

0 Solid The border is displayed as a solid border. 

1 Dashed The border is displayed as a dashed border. 

2 Dotted The border is displayed as a dotted line. 

3 Dash dot The border is displayed as a dash-dot line. 

4 Dash-dot-dot The border is displayed as a dash-dot-dot line. 


The attribute can be assigned dynamic properties using the name BarLineStyle. The data type 
is LONG. 


BarLineWidth property 


Border width - BarLineWidth 
Specifies the border width of the bar. 


The attribute can be assigned dynamic properties using the name BarLineWidth. The data 
type is LONG. 


BarLowerLimit property 


BarLowerLimit 


Specifies the low limit of a tag. If the tag value is less than "BarLowerLimit", the values are 
designated with the color set in "BarLowerLimitColor". This setting is enabled when the 
"BarLowerLimitColoring" attribute has the value "TRUE". 


The attribute can be assigned dynamic properties using the name BarLowerLimit. The data 
type is DOUBLE. 


BarLowerLimitColor property 


BarLowerLimitColor 


Specifies the color for designating tag values below the value at "BarLowerLimit". The setting 
is enabled when the "BarLowerLimitColoring" attribute has the value "TRUE". 


The attribute can be assigned dynamic properties using the name BarLowerLimitColor. The 
data type is LONG. 
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BarLowerLimitColoring property 


BarLowerLimitColoring 


Specifies whether the "BarLowerLimitColor" attribute is used for designating tag values that 
are lower than the value at "BarLowerLimit". 


Value Explanation 
TRUE The "BarLowerLimitColor" attribute is enabled. 
FALSE The "BarLowerLimitColor" attribute is disabled. 


The attribute can be assigned dynamic properties using the name BarLowerLimitColoring. The 
data type is BOOLEAN. 


BarName property 
Object name - BarName 
Specifies the name of the selected diagram. 
The "BarName" attribute can be assigned dynamic properties using the attribute BarRename. 
BarProvider property 
Data source - BarProvider 


Specifies the data source of the selected diagram. 


The following settings are available: 


Value Description Explanation 
0 None No data source configured to create a connection in Runtime by means of a script. 
1 Archive tags Data source with archive tags of a process value archive. 


The attribute can be assigned dynamic properties using the name BarProvider. 


BarProviderCLSID property 


BarProviderCLSID 


Displays the data source of the selected diagram. 


Value Explanation 
No data source configured to create a connection in Runtime by means of a 
script. 

{416A09D2-8B5A-11D2- Data source with archive tags of a process value archive. 


8B81-006097A45D48} 
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The attribute can be assigned dynamic properties using the name BarProviderCLSID. The 
data type is STRING. 


BarRemove property 
Remove - BarRemove 


Removes the selected diagram from the list. 


The attribute can be assigned dynamic properties using the name BarRemove. The data type 
is STRING. 


BarRename property 


BarRename 
Renames the diagram that is referenced using the "Barlndex" attribute. 
The attribute can be assigned dynamic properties using the name BarRename. You can use 
"BarRename" to also assign dynamic properties to the "BarName" attribute. The data type is 
STRING. 

BarRepos property 


Up/down - BarRepos 


Changes the order of the selected diagrams in the diagram window. "Up" and "Down" move 
the selected diagrams up and down in the list. As a result, the diagram is displayed further in 
the foreground or background in runtime. 


The attribute can be assigned dynamic properties using the name BarRepos. The data type 
is LONG. 


BarSelectTagName property 


BarSelectTagName 


Opens a dialog for selecting the tag name for the data source of the diagram. Programmers 
can set this attribute to allow users to select a tag name using a button, for example. 


The attribute can be assigned dynamic properties using the name BarSelectTagName. The 
data type is BOOLEAN. 
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BarTagName property 


Tag name - BarTagName 


Displays the tag name of the connected tag. With the button you open a dialog for selecting 
an archive tag. 


The attribute can be assigned dynamic properties using the name BarTagName. The data 
type is STRING. 


BarTimeAxis property 


Time axis - BarTimeAxis 


Specifies which time axis will be used for the selected diagram. You specify the available time 
axes on the "Time axes" tab. 


The attribute can be assigned dynamic properties using the name BarTimeAxis. The data type 
is STRING. 


BarUncertainColor property 


BarUncertainColor 


Values have an uncertain status if the initial value is unknown when Runtime starts or if a 
substitute value is used. You can use the "BarUncertainColor" attribute to specify the color 
used for identifying these values. The "BarUncertainColoring" attribute determines whether or 
not this setting is evaluated. 


The attribute can be assigned dynamic properties using the name BarUncertainColor. The 
data type is LONG. 


BarUncertainColoring property 


BarUncertainColoring 


Values have an uncertain status if the initial value is unknown when Runtime starts or if a 
substitute value is used. You can use the "BarUncertainColoring" attribute to enable 
identification of such values based on the color set in "BarUncertainColor". 


Value Explanation 
TRUE The setting for the "BarUncertainColor" attribute is enabled. 
FALSE The setting for the " BarUncertainColor " attribute is disabled. 


The attribute can be assigned dynamic properties using the name BarUncertainColoring. The 
data type is BOOLEAN. 
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BarUpperLimitColoring property 


BarUpperLimitColoring 
Specifies whether the "BarUpperLimitColor" attribute is used for designating tag values that 
are higher than the value at "BarUpperLimit". 


Explanation 
TRUE The setting for the "BarUpperLimitColor" attribute is enabled. 
FALSE The setting for the "BarUpperLimitColor" attribute is disabled. 


The attribute can be assigned dynamic properties using the name BarUpperLimitColoring. The 
data type is BOOLEAN. 


BarUpperLimitColor property 


BarUpperLimitColor 
Specifies the color for designating tag values above the value at "BarUpperLimit". The setting 
is enabled when the "BarUpperLimitColoring" attribute has the value "TRUE" hat. 


The attribute can be assigned dynamic properties using the name BarUpperLimitColor. The 
data type is LONG. 


BarUpperLimit property 


BarUpperLimit 
Specifies the high limit of a tag. If the tag value is higher than "BarUpperLimit", the values are 
designated with the color set in "BarUpperLimitColor". This setting is enabled when the 
"BarUpperLimitColoring" attribute has the value "TRUE". 


The attribute can be assigned dynamic properties using the name BarUpperLimit. The data 
type is DOUBLE. 


BarValueAlignment property 


Alignment - BarValueAlignment 
Specifies the alignment of the displayed values for the "Bars with value" diagram type. 


The following settings are available depending on the write direction of the bars: 


e The write direction of bars is "From the right" or "From the left" 
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Value Description Explanation 
0 Bottom The values are displayed at the bottom of the diagram window. 
1 Centered The values are displayed at the center of the diagram window. 
2 Top The values are displayed at the top of the diagram window. 
e@ The write direction of bars is "From the top" or "From the bottom" 
Value Description Explanation 
0 Left The values are displayed at the left of the diagram window. 
1 Centered The values are displayed at the center of the diagram window. 
2 Right The values are displayed at the right of the diagram window. 
The attribute can be assigned dynamic properties using the name BarValueAlignment. The 
data type is LONG. 
BarValueAxis property 


Value axis - BarValueAxis 


Specifies which value axis will be used for the selected diagram. You specify the available 
value axes on the "Value axes" tab. 


The attribute can be assigned dynamic properties using the name BarValueAxis. The data 
type is STRING. 


BarValueUnit property 


Unit - BarValueUnit 


Specifies a unit of the values that will be appended to the value to be displayed for the "Bars 
with value" diagram type. e.g. "%" or "°C" 


The attribute can be assigned dynamic properties using the name BarValueUnit. The data type 
is STRING. 


BarVisible property 


Diagram - BarVisible 


The list shows the diagrams you have created. 
Select the diagrams in the list that you want to display in the diagram windows. 


Click on a diagram in the list to adapt the properties and to assign axes and diagram windows 
to the diagram. 


The attribute can be assigned dynamic properties using the name BarVisible. The data type 
is BOOLEAN. 
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BarWindowAdd property 


New - BarWindowAdd 
Creates a new diagram window. 


The attribute can be assigned dynamic properties using the name BarWindowAdd. The data 
type is STRING. 


BarWindowCoarseGrid property 


Main scaling - BarWindowCoarseGrid 
Enables the display of grid lines for the main scale. 


Value Explanation 
TRUE Enables the display of grid lines for the main scale. 
FALSE Disables the display of grid lines for the main scale. 


The attribute can be assigned dynamic properties using the name BarWindowCoarseGrid. The 
data type is BOOLEAN. 


BarWindowCoarseGridColor property 


Color main scale - BarWindowCoarseGridColor 


Specifies the color of the grid lines for the main scale. Use the button to open the "Color 
selection" dialog to select the color. 


The attribute can be assigned dynamic properties using the name 
BarWindowCoarseGridColor. The data type is LONG. 


BarWindowCount property 


BarWindowCount 
Specifies the number of configured diagrams. 


The attribute can be assigned dynamic properties using the name BarWindowCount. The data 
type is LONG. 
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BarWindowFineGrid property 


Secondary scaling - BarWindowFineGrid 


Specifies whether the grid lines are displayed for the secondary scale. 


Value Explanation 
TRUE Enables the display of grid lines for the secondary scale. 
FALSE Disables the display of grid lines for the secondary scale. 


The attribute can be assigned dynamic properties using the name BarWindowFineGrid. The 


data type is BOOLEAN. 


BarWindowFineGridColor property 


Color secondary scale - BarWindowFineGridColor 
Specifies the color of the grid lines for the secondary scale. Use the button to open the "Color 


selection" dialog to select the color. 


The attribute can be assigned dynamic properties using the name BarWindowFineGridColor. 


The data type is LONG. 


BarWindowForegroundBarGrid property 


For foreground diagram only - BarWindowForegroundBarGrid 
Specifies whether the grid lines for the foreground diagram only will be displayed in the selected 


diagram window. 


Value Explanation 
TRUE The grid lines for the foreground diagram are displayed in the diagram window. 
FALSE The grid lines for all diagrams are displayed in the diagram window. 


The attribute can be assigned dynamic properties using the name 
BarWindowForegroundBarGrid. The data type is BOOLEAN. 


BarWindowGapWicdth property 


Gap width - BarWindowGapWidth 


Specifies the gap between two bars of a bar diagram in % of the bar width. 


The attribute can be assigned dynamic properties using the name BarWindowGapWidth. The 


data type is LONG. 
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BarWindowGridInBarColor property 


In diagram color - BarWindowGridInBarColor 


Specifies whether the grid lines for the main scaling will be displayed in the color of the bars. 


Value Explanation 
TRUE The grid lines are displayed in the color of the bars. 
FALSE The grid lines are displayed with the color set in the "Color" field. 


The attribute can be assigned dynamic properties using the name BarWindowGridInBarColor. 
The data type is BOOLEAN. 


BarWindowHorizontalGrid property 


For value axes - BarWindowHorizontalGrid 


Enables the display of horizontal grid lines for value axes. 


Value Explanation 
TRUE Display of horizontal grids for value axes is enabled. 
FALSE Display of horizontal grid lines for value axes is disabled. 
The attribute can be assigned dynamic properties using the name BarWindowHorizontalGrid. 
BarWindowlndex property 


BarWindowlIndex 


References a configured diagram. Using this attribute, you can assign the values of other 
attributes to a specific diagram. 


Valid values for "BarWindowIndex" are between 0 and "BarWindowCount" minus 1. The 
"BarWindowCount" attribute specifies the number of configured diagrams. 


The "BarWindowlIndex" attribute can be assigned dynamic properties using the attribute 
BarWindowRepos. The data type is LONG. 


BarWindowName property 


Object name - BarWindowName 
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Specifies the name of the selected diagram window. 


The "BarWindowName" attribute can be assigned dynamic properties using the attribute 
BarWindowRename. The data type is STRING. 
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BarWindowRemove property 


Remove - BarWindowRemove 
Removes the selected diagram window from the list. 


The attribute can be assigned dynamic properties using the name BarWindowRemove. The 
data type is STRING. 


BarWindowRename property 


BarWindowRename 
Renames the diagram window, which is referenced using the "BarWindowlndex" attribute. 


The attribute can be assigned dynamic properties using the name BarWindowRename. You 
can use "BarWindowRename" to also assign dynamic properties to the "BarWindowName" 
attribute. The data type is STRING. 


BarWindowRepos property 


Up/down - BarWindowRepos 


Changes the order of the diagram windows. "Up" and "Down" move the selected diagram 
windows up and down in the list. 


The order in the list determines the position in the Control. The first diagram window is 
displayed at the bottommost position, the last diagram window is displayed at the topmost 
position. 


The attribute can be assigned dynamic properties using the name BarWindowRepos. The data 
type is LONG. 


BarWindowSeriesOverlap property 
Overlap - BarWindowBarOverlap 


Specifies the overlap of various bars of a time instant in % of the bar width. 


The attribute can be assigned dynamic properties using the name BarWindowBarOverlap. The 
data type is LONG. 


BarWindowSpacePortion property 
Proportional area - BarWindowSpacePortion 


Specifies the portion of the selected diagram window for the display in the control. 
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The attribute can be assigned dynamic properties using the name BarWindowSpacePortion. 
The data type is LONG. 


BarWindowVerticalGrid property 


For time axes- BarWindowVerticalGrid 


Enables the display of vertical grid lines for time axes. 


Value Explanation 
TRUE Display of vertical grid lines for time axes is enabled. 
FALSE Display of vertical grid lines for time axes is disabled. 


The attribute can be assigned dynamic properties using the name BarWindowVerticalGrid. 


BarWindowvVisible property 


Diagram window - BarWindowVisible 
The list shows the diagram windows you have created. 
Select the diagram windows in the list that you want to display in the control. 
Click on an entry in the list to adapt the properties of the bar display and the grid lines. 


The attribute can be assigned dynamic properties using the name BarWindowVisible. The data 
type is BOOLEAN. 


BarWidth Property 


Description 


Defines or returns the width of the bar in pixels. 


See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 


BasePicReferenced Property 


Description 


TRUE, when the picture assigned in the object status display should be saved. Otherwise, 
only the associated object reference is saved. Read only access. 
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See also 
Status display (Page 199) 
Screenltem Object (Page 125) 


BasePicTransColor Property 


Description 
Defines or returns which color of the assigned bitmap object (.bmp, .dib) should be set to 
"transparent". LONG Write/Read Access. 
The color is only set to "Transparent" if the value of the "BasePicUseTransColor" property is 
"True". 

See also 
Status display (Page 199) 
Screenltem Object (Page 125) 

BasePicture Property 

Description 
Returns the basic picture for the object status display. Read-only access. 
The picture (*.BMP or *.DIB) must be located in the "GraCS" directory of the current project 
so that it can be integrated. 
In this context, the "BasePicReferenced" property defines whether the basic picture should be 
saved together with the object status display or referenced. 

See also 


Status display (Page 199) 
Screenltem Object (Page 125) 


BasePicUseTransColor Property 


Description 


TRUE, when the configured color ("BasePicTransColor" property) of the bitmap objects should 
be set to "transparent". BOOLEAN write-read access. 


See also 
Status display (Page 199) 
Screenltem Object (Page 125) 
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BaseScreenName Property 


Function 


HMTRuntime.Bas 


Defines or returns the current basic picture. 
STRING (write-read access) 


A picture change is executed using the 


Example: 


HMTRuntime.Bas 


ScreenName = (<Serverprafix>::)<Neues Grundbild> 


command. 


When reading out the "BaseScreenName" property, only the picture name without server prefix 
is returned. 


Note 


Always enter picture names without the extension "PDL" for reasons of compatibility with future 
versions. 


The following example executes a picture change to "bild1.pdl": 


ScreenName = "bildl" 


See also 


BaseY Property 


Description 


See also 
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Screenltem Object (Page 125) 
HM IRuntime Object (Page 118) 


Defines or returns the vertical distance of the bottom bar edge to the top edge of the objet field. 


3D Bar (Page 169) 
Screenltem Object (Page 125) 
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BaseX Property 


Description 


Defines or returns the horizontal distance of the right bar edge to the left edge of the object 
field in pixels. 


See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 
Be - BI 
BeginTime Property 
Description 
WinCC Online Trend Control 
The "Index" property references a pair of columns. "BeginTime" defines the start time for 
displaying this column pair. Write/Read access. 
WinCC Online Trend Control 
The "Index" property references a trend. "BeginTime" defines the start time for displaying this 
trend. Whether the information is evaluated is dependent on the TimeRange" and "CommonxX" 
properties. 
Use the "yyyy-mm-dd hh:mm:ss" format when creating a dynamic time range. 
See also 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 
BeginValue Property 
Description 


The "Index" property references a trend. "BeginValue" defines the lower limit of the value range 
to be displayed for the trend. Whether the information is evaluated is dependent on the 
"Autorange" and "CommonyY" properties. 
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See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 

BeginX Property 

Description 
Defines or returns the lower limit of the X-axis of a trend referenced with the "Index" property. 
Whether the information is evaluated is dependent on the "Autorangex" and "Commonx" 
properties. 

See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 

BeginY Property 

Description 
Defines or returns the lower limit of the Y-axis of a trend referenced with the "Index" property. 
Whether the information is evaluated is dependent on the "AutorangeY" and "CommonyY" 
properties. 

See also 


Screenltem Object (Page 125) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 


BevelColorDown Property 


Description 
Defines the color of the following border sections in the case of 3D representation of the 
borders: 
e with depressed bevel ("BevelStyle" = 1): top and left bevel section 
e with raised bevel ("BevelStyle" = 2): bottom and right bevel section 
See also 


WinCC Slider Control (Page 277) 
Screenltem Object (Page 125) 
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BevelColorUp Property 


Description 


Defines the color of the following border sections in the case of 3D representation of the 
borders: 


e with depressed bevel ("BevelStyle" = 1): bottom and right bevel section 


e with raised bevel ("BevelStyle" = 2): top and left bevel section 


See also 
WinCC Slider Control (Page 277) 
Screenltem Object (Page 125) 


Bevellnner Property 


Description 
Defines or returns the appearance of the inner part of the object bevel. Write/Read access. 
@ 0: inner part not available 
e 1: "depressed" appearance 
e 2:"raised" appearance 
e 3: uniform gray border 


e 4 or higher: uniformly colored order, border color = background color 


See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 


BevelOuter Property 


Description 
Defines or returns the appearance of the outer part of the object bevel. Write/Read access. 
@ 0: inner part not available 
e 1: "depressed" appearance 
e 2:"raised" appearance 
e 3: uniform gray border 


e 4 or higher: uniformly colored order, border color = background color 
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See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 


BevelWidth Property 


Description 
Defines or returns the border width for the inner part of the border (inner bevel) and for the 
outer border part (outer bevel) in pixels. Write/Read access. 

See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 

BitNumber Property 

Description 
Defines or returns the bit whose status must change in order to trigger a change of value. The 
tag used must be of the type BYTE, WORD or DWORD. 

See also 


Text list (Page 196) 
Screenltem Object (Page 125) 


BlinkColor Property 


Description 
Defines the color of the icon in the flash picture. LONG write-read access. 


See also 
HMI Symbol Library (Page 239) 
Screenltem Object (Page 125) 
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BlinkMode property 


Flash mode (BlinkMode) 
Specifies the flash mode of the icon in runtime. 


The following settings are available: 


Value Description Comments 

0 No flashing The icon does not flash. 

1 Hidden The icon flashes in the background color. 

2 Shadow The icon flashes with shading in the foreground color. 
3 Solid The icon flashes in the foreground color. 


The attribute can be assigned dynamic properties by means of the name BlinkMode. The data 
type is LONG. 


BlinkSpeed property 


Flash rate (BlinkSpeed) 
Specifies the length of the icon flash interval in Runtime. 


The following settings are available: 


Value Description Comments 

250 Fast Flash interval of 250 ms. 
500 Medium Flash interval of 500 ms. 
1000 Slow Flash interval of 1000 ms. 


The attribute can be assigned dynamic properties by means of the name BlinkSpeed. You can 
also use other values. The data type is LONG. 


BlockAlign property 
Block alignment - BlockAlign 


Defines the mode of aligning the caption of blocks in column headers. 


The following settings are available: 


Value Description Explanation 

0 left The block caption is left justified. 

1 centered The block caption is aligned to center. 
2 right The block caption is right justified. 


The attribute can be assigned dynamic properties by means of the name BlockAlign. The data 
type is LONG. 
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BlockAutoPrecisions property 


Decimal places automatic - BlockAutoPrecisions 
Enables automatic setting of the decimal precision. 


Value Explanation 
TRUE The decimal precision is defined automatically. The value in the "Decimal places" field is disabled. 
FALSE The value in the "Decimal places" field is enabled. 


The attribute can be assigned dynamic properties by means of the name 
BlockAutoPrecisions. The data type is BOOLEAN. 


BlockCaption property 


Caption - BlockCaption 
Defines the caption of the column header in the control for the selected message block. 


The caption is active in all Runtime languages. 


The attribute can be assigned dynamic properties by means of the name BlockCaption. The 
data type is STRING. 


BlockCount property 


BlockCount 
Specifies the number of blocks to be made available as columns for the control. 


The attribute can be assigned dynamic properties by means of the name BlockCount. The 
data type is LONG. 


BlockDateFormat property 
Date format - BlockDateFormat 


Defines the date format for visualization. 


The following date formats are available: 


Value Explanation 

Automatic The date format is set automatically. 
dd.MM.yy Day.Month.Year, e.g. 24.12.07. 
dd.MM.yyyy Day.Month.Year, e.g. 24.12.2007. 
dd/MM/yy Day/Month/Year, e.g. 24/12/07. 
dd/MM/yyyy Day/Month/Year, e.g. 24/12/2007. 
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The attribute can be assigned dynamic properties by means of the name BlockDateFormat. 
The data type is STRING. 


BlockExponentialFormat property 


Exponential notation - BlockExponentialFormat 


Specifies exponential notation for the display of values of a selected block. 


Value Explanation 
TRUE The values are displayed with exponential notation. 
FALSE The values are displayed with decimal notation. 
The attribute can be assigned dynamic properties by means of the name 
BlockExponentialFormat. The data type is BOOLEAN. 
BlockHideText property 


Content as text - BlockHideText 


Enables the textual display of the content of a selected block. 


Value Explanation 
TRUE The content is not displayed in text format. The option is disabled. 
FALSE The content is displayed in text format. The option is enabled. 
The attribute can be assigned dynamic properties by means of the name BlockHideText. The 
data type is BOOLEAN. 
BlockHideTitleText property 


Title as text - BlockHideTitleText 


Enables the display of the header of a selected block in text format. 


Value Explanation 
TRUE 


The header is not displayed in text format. The option is disabled. 
FALSE 


The header is displayed in text format. The option is enabled. 


The attribute can be assigned dynamic properties by means of the name BlockHideTitleText. 
The data type is BOOLEAN. 
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Blockld property 


Blockld 
Default assignment of the ID number and of the block in WinCC RulerControl: 
Value Description 
0 No block 
1 Name 
2 Index 
3 Designation 
4 Display 
5 Tag name Y 
6 Tag name X 
7 Y value 
8 X value/time stamp 
9 Y value (LL) 
10 Time stamp (LL) 
1 Y value (UL) 
12 Time stamp (UL) 
13 Minimum 
14 Minimum - Time stamp 
15 Maximum 
16 Maximum - Time stamp 
17 Average 
18 Standard deviation 
19 Integral 
20 Weighted mean value 
21 Duration 
22 Number of values 
The attribute can be assigned dynamic properties by means of the name BlockID. The data 
type is LONG. 
BlockIndex property 
Blockindex 
References a block. Using this attribute you can assign the values of other attributes to a 
specific block. 
Values between 0 and "BlockCount" minus 1 are valid for "BlockIndex". Attribute "BlockCount" 
defines the number of available blocks. 
The attribute can be assigned dynamic properties by means of the name BlockIndex. The data 
type is LONG. 
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BlockLength property 


Length in characters - BlockLength 
Specifies the column width for a selected block. 


The attribute can be assigned dynamic properties by means of the name BlockLength. The 
data type is LONG. 


BlockName property 


Object name - BlockName 
Displays the name of the block selected. You cannot edit this name. 


The attribute can be assigned dynamic properties by means of the name BlockName. The 
data type is STRING. 


BlockPrecisions property 


Decimal places - BlockPrecisions 


Specifies the number of decimal places of the values in the selected column. You can only 
enter the value if the "Automatic" option is disabled. 


The attribute can be assigned dynamic properties by means of the name BlockPrecisions. The 
data type is SHORT. 


BlockShowDate property 


Display date - BlockShowDate 


Specifies if the "Time" block is displayed with time and date in a field. 


Value Explanation 
TRUE The date and time are displayed. The date format is defined in the "Date format" field. 
FALSE The time is displayed. 


The attribute can be assigned dynamic properties by means of the name BlockShowDate. The 
data type is BOOLEAN. 


BlockShowlcon property 


Content as icon - BlockShowlcon 
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Enables the display of the content of a selected block as icon. This function is only available 
in WinCC Alarm Control. 


Value Explanation 
TRUE The content is visualized as icon. 
FALSE The content is not visualized as icon. 
The attribute can be assigned dynamic properties by means of the name BlockShowlcon. The 
data type is BOOLEAN. 
BlockShowTitlelcon property 
Title as icon - BlockShowTitlelcon 
Enables the display of the header of a selected block as icon. This function is only available 
in WinCC Alarm Control. 
Value Explanation 
TRUE The header is displayed as icon. 
FALSE The header is not displayed as icon. 
The attribute can be assigned dynamic properties by means of the name BlockShowTitlelcon. 
The data type is BOOLEAN. 
BlockTimeFormat property 


Time format - BlockTimeFormat 


Defines the time format to be used for visualization. 


The following time formats are available: 


Value 
Automatic 


HH:mm:ss.ms 


Explanation 
The time format is set automatically. 
Hours:Minutes:Seconds, e.g. 15:35:44.240. 


hh:mm:ss tt 


Hours:Minutes:Seconds AM/PM, e.g. 03:35:44 PM. 


hh:mm:ss.ms tt 


Hours:Minutes:Seconds.Milliseconds AM/PM, e.g. 03:35:44.240 PM. 


The attribute can be assigned dynamic properties by means of the name BlockTimeFormat. 
The data type is STRING. 


BlockUseSourceFormat property 
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Use source format - BlockUseSourceFormat 
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Specifies that the format is inherited from the interconnected control. Here the size of the 
control, the zoom factor and the value range are taken into consideration to display the optimal 
number of decimal places. 


Value Explanation 

TRUE The formats are derived from the interconnected control. 

FALSE The formats configured in Ruler Control are used, for example, the display of a precisely specified number of 
decimal places. 


The attribute can be assigned dynamic properties by means of the name 
BlockUseSouceFormat. The data type is BOOLEAN. 


Bo - Bu 
BorderBackColor Property 
Description 
Defines or returns the background color of the line for the object. LONG write-read access. 
The background color is only visible with the property setting "BorderWidth" > 0. 
See also 
Screenltem Object (Page 125) 
BorderColor Property 
Description 
Defines or returns the line color for the object. LONG write-read access. 
See also 
Screenltem Object (Page 125) 
BorderColor property 


Border color - BorderColor 
Specifies the border color. The button opens the "Color selection" dialog. 


The attribute can be assigned dynamic properties by means of the name BorderColor. The 
data type is LONG. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 353 


VBS for Creating Procedures and Actions 
7.14 VBS Reference 


BorderColorBottom Property 


Description 
Defines or returns the border color for the bottom/right part of the object. LONG write-read 
access. 
See also 
Screenltem Object (Page 125) 
Button (Page 201) 
Round Button (Page 209) 
BorderColorTop Property 
Description 
Defines or returns the border color for the top/left part of the object. LONG write-read access. 
See also 


Button (Page 201) 
Round Button (Page 209) 
Screenltem Object (Page 125) 


BorderEndStyle Property 


Description 
Defines or returns the line end style of the object. LONG write-read access. 


See also 
Polyline (Page 158) 
Line (Page 154) 
Screenltem Object (Page 125) 


BorderFlashColorOff Property 


Description 


Defines or returns the color of the object lines for the flashing status "Off". LONG write-read 
access. 
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See also 
Screenltem Object (Page 125) 


BorderFlashColorOn Property 


Description 
Defines or returns the color of the object lines for the flashing status "On". LONG write-read 
access. 
See also 
Screenltem Object (Page 125) 
BorderStyle Property 
Description 
Defines or returns the line style for the object. Value range from 0 to 4. 
0 = solid line 
1 = dashed line 
2 = dotted line 
3 = dash-dotted line 
4 = dash-dot-dot line 
See also 
Screenltem Object (Page 125) 
BorderWidth Property 
Description 


Defines or returns the line weight (in pixels) for the object. 


WinCC Gauge Control: 
Defines or returns the width of the middle border part in pixels. 


The object border is composed of three parts. The middle part of the object border is described 
by the "BorderWidth" property. 


The color of the middle border part is in the background color. 
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See also 
Screenltem Object (Page 125) 


BorderWidth property 


Border width - BorderWidth 
Specifies the line weight of the border in pixels. 


The attribute can be assigned dynamic properties by means of the name BorderWidth. The 
data type is LONG. 


BottomConnectedConnectionPointIndex Property 

Description 
Specifies or sets the index number of the bottom connecting point. 
LONG write-read access. 

See also 
Connector (Page 167) 


Screenltem Object (Page 125) 


BottomConnectedObjectName Property 


Description 
Specifies or sets the object name of the object which is docked on at the bottom connecting 
point. 
LONG write-read access. 

See also 


Connector (Page 167) 
Screenltem Object (Page 125) 


BoxAlignment Property 
Description 


TRUE, when the fields are arranged aligned to the right. BOOLEAN write-read access. 
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See also 
Radio box (Page 207) 
Check box (Page 204) 
Screenltem Object (Page 125) 
BoxCount Property 
Description 
Defines or returns the number of fields. Value range from 0 to 31. 
See also 
Radio box (Page 207) 
Check box (Page 204) 
Screenltem Object (Page 125) 
BoxType Property 
Description 
Defines or returns the field type. Value range from 0 to 2: 
e 0: Edition 
e@ 1: Input 
e 2: 1/0 field 
See also 
Text list (Page 196) 
I/O Field (Page 184) 
Screenltem Object (Page 125) 
ButtonColor Property 
Description 


Defines or returns the color of the slider. LONG write-read access. 
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See also 


Slider (Page 212) 
Screenltem Object (Page 125) 


ButtonCommand Property 


Description 
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Upon changing a value of "ButtonCommand", a message is issued to the WinCC Alarm Control 
in order to adapt the display in the message window. 


Value (hex); value (dec); Retrieved Function: 


0x00000001; 1; Message list 

0x00000002; 2; Short-term archive list 
0x00000004; 4; Long-term archive list 
0x00200000; 2097152; Lock list 

0x00000008; 8; Acknowledge central signaling device 
0x00000010; 16; Single Acknowledgment 
0x00000020; 32; Group Acknowledge 
0x00000040; 64; Autoscroll 

0x00000080; 128; Selection Dialog 

0x00000100; 256; Lock Dialog 

0x00000200; 512; Print Message Log 
0x00000800; 2048; Emergency Acknowledgment 
0x00001000; 4096; First Message 

0x00002000; 8192; Last Message 

0x00004000; 16384; Next Message 
0x00008000; 32768; Previous Message 
0x00010000; 65536; Infotext Dialog 
0x00020000; 131072; Comments Dialog 
0x00040000; 262144; Loop in Alarm 
0x00100000; 1048576; Print current view 
0x00400000; 4194304; Lock/unlock message 
0x00800000; 8388608; Sorting Dialog 
0x01000000; 16777216; Time base dialog 
0x02000000; 33554432; Hit list 

0x04000000; 67108864; List of messages to be hidden 
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@ 0x08000000; 134217728; Show/hide message 
@ 0x10000000; 268435456; Display option dialog 


See also 
WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 


Button1MessageClasses property 
Message Types for Button 1 (Button1 MessageClasses) 


Define one or more message events for displaying the first button in the group display. This is 
done by entering the numbers of the bits in the collect value. The display of the message events 
is configured in the "Message Types" property group. 


If you want to assign several message events, separate the numbers with a comma. The 
sequence of the assignment defines the priority. If there are more than one selected event for 
one button, the event that has been entered first is displayed. 


One event can be displayed simultaneously in more than one button. 


The "Message Types for Button 1" attribute can be assigned dynamic properties with the name 
"ButtoniMessageClasses". 


Button2MessageClasses property 
Message Types for Button 2 (Button2MessageClasses) 


For displaying both buttons, define one or more message events in the group display. This is 
done by entering the number of the bit in the collect value. The display of the message events 
is configured in the "Message Types" property group. 


If you want to assign several message events, separate the numbers with a comma. The 
sequence of the assignment defines the priority. If there are more than one selected event for 
one button, the event that has been entered first is displayed. 


The same event can be visualized simultaneously in several buttons. 


The "Message Types for Button 2" attribute can be assigned dynamic properties with the name 
"Button2MessageClasses". 


Button3MessageClasses property 
Message Types for Button 3 (Button3MessageClasses) 


For displaying the third button, define one or more message events in the group display. This 
is done by entering the number of the bit in the collect value. The display of the message events 
is configured in the "Message Types" property group. 


If you want to assign several message events, separate the numbers with a comma. The 
sequence of the assignment defines the priority. If there are more than one selected event for 
one button, the event that has been entered first is displayed. 


The same event can be visualized simultaneously in several buttons. 
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The "Message Types for Button 3" attribute can be assigned dynamic properties with the name 
"Button3MessageClasses". 


Button4MessageClasses property 


Message Types for Button 4 (Button4MessageClasses) 


For displaying the fourth button, define one or more message events in the group display. This 
is done by entering the number of the bit in the collect value. The display of the message events 
is configured in the "Message Types" property group. 


If you want to assign several message events, separate the numbers with a comma. The 
sequence of the assignment defines the priority. If there are more than one selected event for 
one button, the event that has been entered first is displayed. 


The same event can be visualized simultaneously in several buttons. 


The "Message Types for Button 4" attribute can be assigned dynamic properties with the name 
"Button4MessageClasses". 


Button5MessageClasses property 


Message Types for Button 5 (Button5MessageClasses) 


For displaying the fifth button, define one or more message events in the group display. This 
is done by entering the number of the bit in the collect value. The display of the message events 
is configured in the "Message Types" property group. 


If you want to assign several message events, separate the numbers with a comma. The 
sequence of the assignment defines the priority. If there are more than one selected event for 
one button, the event that has been entered first is displayed. 


The same event can be visualized simultaneously in several buttons. 


The "Message Types for Button 5" attribute can be assigned dynamic properties with the name 
"ButtonSMessageClasses". 


Button6MessageClasses property 
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Message Types for Button 6 (Button6MessageClasses) 


For displaying the sixth button, define one or more message events in the group display. This 
is done by entering the number of the bit in the collect value. The display of the message events 
is configured in the "Message Types" property group. 


If you want to assign several message events, delimit the numbers with a comma. The order 
of assignment defines the priority. If there are more than one selected event for one button, 
the event that has been entered first is displayed. 


The same event can be visualized simultaneously in several buttons. 


The "Message Types for Button 6" attribute can be assigned dynamic properties with the name 
"Button6MessageClasses". 
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Button7MessageClasses property 
Message Types for Button 7 (Button7 MessageClasses) 


For displaying the seventh button, define one or more message events in the group display. 
This is done by entering the number of the bit in the collect value. The display of the message 
events is configured in the "Message Types" property group. 


If you want to assign several message events, delimit the numbers with a comma. The order 
of assignment defines the priority. If there are more than one selected event for one button, 
the event that has been entered first is displayed. 


The same event can be visualized simultaneously in several buttons. 


The "Message Types for Button 7" attribute can be assigned dynamic properties with the name 
"Button7MessageClasses". 


Button8MessageClasses property 
Message Types for Button 8 (Button8MessageClasses) 


For displaying the eighth button, define one or more message events in the group display. This 
is done by entering the number of the bit in the collect value. The display of the message events 
is configured in the "Message Types" property group. 


If you want to assign several message events, delimit the numbers with a comma. The order 
of assignment defines the priority. If there are more than one selected event for one button, 
the event that has been entered first is displayed. 


The same event can be visualized simultaneously in several buttons. 


The "Message Types for Button 8" attribute can be assigned dynamic properties with the name 
"Button’MessageClasses". 


Button1Width Property 


Description 


Defines or returns the width of the Button 1 in pixels. 
When the SameSize property is set to TRUE, all the buttons are specified the same width. 


See also 
Group Display (Page 194) 
Screenltem Object (Page 125) 


Button2Width Property 


Description 


Defines or returns the width of the Button 2 in pixels. 
When the SameSize property is set to TRUE, all the buttons are specified the same width. 
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See also 
Group Display (Page 194) 
Screenltem Object (Page 125) 


Button3Width Property 


Description 


Defines or returns the width of the Button 3 in pixels. 
When the SameSize property is set to TRUE, all the buttons are specified the same width. 


See also 
Screenltem Object (Page 125) 
Group Display (Page 194) 


Button4Width Property 


Description 
Defines or returns the width of the Button 4 in pixels. 
When the SameSize property is set to TRUE, all the buttons are specified the same width. 
See also 
Group Display (Page 194) 
Screenltem Object (Page 125) 
1.14.4.4 Cc 
Ca -Cl 


Caption Property 


Description 


Application and picture windows 
TRUE, when the application or picture window has a title bar in Runtime. Read only access. 


The Caption property must be set to TRUE when the application or picture window should 
have Maximize and Close buttons. 
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Controls before WinCC V7 


Defines or returns the text to be displayed on the label on the button or in the title bar (Online 
Trend Control and Online Table Control). Write/Read access. 


See also 
Controls (Page 218) 
Picture Window (Page 179) 
Application Window (Page 173) 
Screenltem Object (Page 125) 


Caption property 


Text - Caption 
Defines the text of the window caption. 
The attribute can be assigned dynamic properties by means of the name Caption. The data 
type is STRING. 
CaptionColor Property 
Description 
Defines or returns the color of the element labeling. LONG write-read access. 
See also 
Screenltem Object (Page 125) 
WinCC Gauge Control (Page 254) 
CaptionFont Property 
Description 
Returns the values for font, font style and font size as well as the "Underline" and 
"Strikethrough" effects for the element labeling. Read only access. 
See also 


WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 363 


VBS for Creating Procedures and Actions 
7.14 VBS Reference 


CaptionOffset Property 


Description 


Defines or returns the distance of the element labeling in relation to the top edge of the object. 
The element labeling can only be positioned along the vertical diameter of the graduated scale 
disk. The value of the attribute is related to the height of the object and is measured from the 
top edge of the object to the base of the text. Write/Read access. 


The value range is 0 to 1: 


0: The base of the text is at the top limit of the object. The text is no longer visible because it 
is outside the object. 


1: The base of the text is at the bottom limit of the object. 


See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 
CaptionText Property 
Description 
Defines or returns the window title which is displayed in Runtime. 
The Caption property must be set to TRUE. 
See also 


Picture Window (Page 179) 
Screenltem Object (Page 125) 


CellCount property 


CellCount 


Specifies the number of cells of the Row object of a Table Control. The number of cells 
corresponds to the number of columns. 


CellCut property (before WinCC V7) 


Description 


TRUE, when the content of the cells in a message line should be cut if the column width is too 
small. BOOLEAN write-read access. 
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See also 
WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 


CellCut property 


Shorten contents - CellCut 


Shortens cell contents if the cell width is insufficient. 


Value Explanation 
TRUE Enables shortening of cell contents. 
FALSE Disables shortening of cell contents. 


The attribute can be assigned dynamic properties by means of the name CellCut. The data 
type is BOOLEAN. 


CellSpaceBottom property 


CellSpaceBottom 
Defines the bottom margin of the table cells. 


The attribute can be assigned dynamic properties by means of the name CellSpaceBottom. 
The data type is LONG. 


CellSpaceLeft property 


CellSpaceLeft 
Defines the left indent of the table cells. 


The attribute can be assigned dynamic properties by means of the name CellSpaceLeft . The 
data type is LONG. 


CellSpaceRight property 


CellSpaceRight 
Defines the right indent of the table cells. 


The attribute can be assigned dynamic properties by means of the name CellSpaceRight . The 
data type is LONG. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 365 


VBS for Creating Procedures and Actions 
7.14 VBS Reference 


CellSpaceTop property 


CellSpaceTop 
Defines the top margin of the table cells. 


The attribute can be assigned dynamic properties by means of the name CellSpaceTop . The 
data type is LONG. 


CellText property 


CellText 
Returns the contents of a cell as a string. The cell is determined from the column number of 
the row object, e.g. CellText(3) for the third column. Numbering runs from "1" to "CellCount". 
CenterColor Property 
Description 
Defines or returns the color of the circular center of the scale (cover of the pointer axis). LONG 
write-read access. 
See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 
CenterScale Property 
Description 
Defines or returns the diameter of the circular center of the scale (cover of the pointer axis) in 
relation to the smaller value of the geometric width and height attributes. Write/Read access. 
The value range is 0.03 to 1: 
1: The diameter corresponds to the smaller value of the "Width" or "Height" geometric values. 
See also 


WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 
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CheckAlarmHigh Property 


Description 
TRUE, when the "AlarmHigh" limit value is to be monitored. BOOLEAN write/read access. 
The limit value, the display on reaching the limit value and the type of evaluation are defined 
by means of the "AlarmHigh", "ColorAlarmHigh" and "TypeAlarmHigh" properties. 

See also 
Bar (Page 174) 
Screenltem Object (Page 125) 

CheckAlarmLow Property 

Description 
TRUE, when the "AlarmLow" limit value is to be monitored. BOOLEAN write/read access. 
The limit value, the display on reaching the limit value and the type of evaluation are defined 
by means of the "AlarmLow'", "ColorAlarmLow" and "TypeAlarmLow" properties. 

See also 
Bar (Page 174) 
Screenltem Object (Page 125) 

CheckLimitHigh4 Property 

Description 
TRUE, when the "Reserve 4" upper limit value should be monitored. BOOLEAN write/read 
access. 
The limit value, the display on reaching the limit value and the type of evaluation are defined 
by means of the "LimitHigh4", "ColorLimitHigh4" and "TypeLimitHigh4" properties. 

See also 


Bar (Page 174) 
Screenltem Object (Page 125) 
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CheckLimitHigh5 Property 


Description 


TRUE, when the "Reserve 5" upper limit value should be monitored. BOOLEAN write/read 
access. 

The limit value, the display on reaching the limit value and the type of evaluation are defined 
by means of the "LimitHigh5", "ColorLimitHigh5" and "TypeLimitHigh5" properties. 


See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
CheckLimitLow4 Property 
Description 
TRUE, when the "Reserve 4" lower limit value should be monitored. BOOLEAN write/read 
access. 
The limit value, the display on reaching the limit value and the type of evaluation are defined 
by means of the "LimitLow4", "ColorLimitLow4" and "TypeLimitLow4" properties. 
See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
CheckLimitLow5 Property 
Description 
TRUE, when the "Reserve 5" lower limit value should be monitored. BOOLEAN write/read 
access. 
The limit value, the display on reaching the limit value and the type of evaluation are defined 
by means of the "LimitLow5", "ColorLimitLow5" and "TypeLimitLow5" properties. 
See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
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CheckToleranceHigh Property 


Description 


See also 


TRUE, when the "ToleranceHigh" limit value is to be monitored. BOOLEAN write/read access. 
The limit value, the display on reaching the limit value and the type of evaluation are defined 
by means of the "ToleranceHigh", "ColorToleranceHigh" and "TypeToleranceHigh" properties. 


Bar (Page 174) 
Screenltem Object (Page 125) 


CheckToleranceLow Property 


Description 


See also 


TRUE, when the "ToleranceLow" limit value is to be monitored. BOOLEAN write/read access. 
The limit value, the display on reaching the limit value and the type of evaluation are defined 
by means of the "ToleranceLow", "ColorToleranceLow" and "TypeToleranceLow" properties. 


Bar (Page 174) 
Screenltem Object (Page 125) 


CheckWarningHigh Property 


Description 


See also 


TRUE, when the "WarningHigh" limit value is to be monitored. BOOLEAN write/read access. 
The limit value, the display on reaching the limit value and the type of evaluation are defined 
by means of the "WarningHigh", "ColorWarningHigh" and "TypeWarningHigh" properties. 


Bar (Page 174) 
Screenltem Object (Page 125) 
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CheckWarningLow Property 


Description 
TRUE, when the "WarningLow" limit value is to be monitored. BOOLEAN write/read access. 
The limit value, the display on reaching the limit value and the type of evaluation are defined 
by means of the "WarningLow", "ColorWarningLow" and "TypeWarningLow" properties. 
See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
ClearOnError Property 
Description 
TRUE, when the field entry is automatically deleted in the case of invalid input. BOOLEAN 
write-read access. 
See also 
I/O Field (Page 184) 
Screenltem Object (Page 125) 
ClearOnNew Property 
Description 
TRUE, when the field entry is deleted as soon as the I/O field has the focus. BOOLEAN write- 
read access. 
See also 


I/O Field (Page 184) 
Screenltem Object (Page 125) 


Closeable property (before WinCC V7) 


Description 
TRUE, when the window can be closed in Runtime. BOOLEAN write-read access. 
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See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
Screenltem Object (Page 125) 

Closeable property 

Closeable 
Defines whether the control can be closed in Runtime. 

Value Explanation 

TRUE The control can be closed in Runtime. 

FALSE The control cannot be closed in Runtime. 


The attribute can be assigned dynamic properties by means of the name Closeable. The data 
type is BOOLEAN. 


CloseButton Property 


Description 

TRUE, when the window is provided with a "Close" button. Read only access. 
See also 

Picture Window (Page 179) 

Application Window (Page 173) 

Screenltem Object (Page 125) 
Co 


CoarseGrid Property 


Description 


TRUE when the value axis is scaled by long tick marks. The distance between two long tick 
marks can be changed using the "CoarseGridValue" property. BOOLEAN write-read access. 
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See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 
CoarseGridX Property 
Description 
TRUE, when the X-axis graduation is scaled by long tick marks. The distance between two 
long tick marks can be changed using the "CoarseGridValueX" property. BOOLEAN write-read 
access. 
See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
CoarseGridY Property 
Description 
TRUE, when the Y-axis graduation is scaled by long tick marks. The distance between two 
long tick marks can be changed using the "CoarseGridValueY" property. BOOLEAN write-read 
access. 
See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
CoarseGridValue Property 
Description 
Defines the distance between two long tick marks in the scale. Whether the information is 
evaluated is dependent on the value of the "CoarseGrid" property. 
See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 
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CoarseGridValueX Property 


Description 


Defines or returns the distance between two long tick marks on the graduation scale of the X- 
axis. Whether the information is evaluated is dependent on the value of the "CoarseGridX" 
property. 


See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 

CoarseGridValueY Property 

Description 
Defines or returns the distance between two long tick marks on the graduation scale of the Y- 
axis. Whether the information is evaluated is dependent on the value of the "CoarseGridY" 
property. 

See also 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


CollectValue Property 


Description 


See also 


Contains the respective status of the active message class in Runtime as the start value. LONG 
write/read access. 

The value can be determined from the group display of hierarchically subordinate pictures by 
making it dynamic using a tag. 


Group Display (Page 194) 
Screenltem Object (Page 125) 
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ColMove Property 


Description 


See also 


Color Property 


Description 


See also 


TRUE, when the arrangement of columns can be changed. BOOLEAN write-read access. 


WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 


The "Index" property references a column pair or a trend. "Color" defines the color of the font 
in the column or the trend. LONG write-read access. The color is defined as an RGB value. 


WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


ColorAlarmHigh Property 


Description 


See also 


374 


Defines or returns the bar color for the "AlarmHigh" limit value. LONG write/read access. 
The "CheckAlarmHigh" property must have been set to TRUE if the bar color should change 
on reaching the limit value. 


Bar (Page 174) 
Screenltem Object (Page 125) 
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ColorAlarmLow Property 


Description 


Defines or returns the bar color for the "AlarmLow" limit value. LONG write/read access. 
The "CheckAlarmLow" property must have been set to TRUE if the bar color should change 
on reaching the limit value. 


See also 
Bar (Page 174) 
Screenltem Object (Page 125) 

ColorBottom Property 

Description 
Defines or returns the color for the bottom/right stop of the slider object. LONG write-read 
access. 

See also 
Slider (Page 212) 
Screenltem Object (Page 125) 

ColorChangeType Property 

Description 
TRUE, if the change of color should occur segment by segment in the case of a color change 
(e.g. on reaching a limit value). If set to FALSE, it defines the change of color for the entire 
bar. BOOLEAN write-read access. 

See also 


Bar (Page 174) 
Screenltem Object (Page 125) 
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ColorLimitHigh4 Property 


Description 


See also 


Defines or returns the color for the "Reserve 4" upper limit value. LONG write/read access. 
The "CheckLimitHigh4" property must have been set to TRUE if the bar color should change 
on reaching the limit value. 


Bar (Page 174) 
Screenltem Object (Page 125) 


ColorLimitHigh5 Property 


Description 


See also 


Defines or returns the color for the "Reserve 5" upper limit value. LONG write/read access. 
The "CheckLimitHigh5" property must have been set to TRUE if the bar color should change 
on reaching the limit value. 


Bar (Page 174) 
Screenltem Object (Page 125) 


ColorLimitLow4 Property 


Description 


See also 


376 


Defines or returns the color for the "Reserve 4" lower limit value. LONG write/read access. 
The "CheckLimitLow4" property must have been set to TRUE if the bar color should change 
on reaching the limit value. 


Bar (Page 174) 
Screenltem Object (Page 125) 
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ColorLimitLow5 Property 


Description 


Defines or returns the color for the "Reserve 5" lower limit value. LONG write/read access. 
The "CheckLimitLow5" property must have been set to TRUE if the bar color should change 
on reaching the limit value. 


See also 
Bar (Page 174) 


Screenltem Object (Page 125) 


ColorToleranceHigh Property 


Description 
Defines or returns the color for the "ToleranceHigh" upper limit value. LONG write/read access. 
The "CheckToleranceHigh" property must have been set to TRUE if the bar color should 
change on reaching the limit value. 

See also 


Bar (Page 174) 
Screenltem Object (Page 125) 


ColorToleranceLow Property 


Description 
Defines or returns the color for the "ToleranceLow" lower limit value. LONG write/read access. 
The "CheckToleranceLow" property must have been set to TRUE if the bar color should change 
on reaching the limit value. 

See also 
Bar (Page 174) 
Screenltem Object (Page 125) 

ColorTop Property 

Description 


Defines or returns the color for the top/left stop of the slider object. LONG write-read access. 
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See also 
Slider (Page 212) 
Screenltem Object (Page 125) 


ColorWarningHigh Property 


Description 
Defines or returns the color for the "WarningHigh" upper limit value. LONG write/read access. 
The "CheckWarningHigh" property must have been set to TRUE if the bar color should change 
on reaching the limit value. 

See also 
Bar (Page 174) 
Screenltem Object (Page 125) 

ColorWarningLow Property 

Description 
Defines or returns the color for the "WarningLow" lower limit value. LONG write/read access. 
The "CheckWarningLow" property must have been set to TRUE if the bar color should change 
on reaching the limit value. 

See also 
Bar (Page 174) 
Screenltem Object (Page 125) 

ColTitle Property 

Description 
TRUE, when the columns in the message window should have a title bar. BOOLEAN write- 
read access. 

See also 


WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 
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ColumnAdd property 


Apply - ColumnAdd 
Copies the selected column from the list of existing columns to the list of selected columns. 


The attribute can be assigned dynamic properties by means of the name ColumnAdd. The 
data type is STRING. 


ColumnAlias property 


ColumnAlias 
Defines the alias specified in the user archive for the column name. 


The attribute can be assigned dynamic properties by means of the name ColumnAlias. The 
data type is STRING. 


ColumnAlign property 
Alignment - ColumnAlign 


Specifies the mode of alignment of a selected column. 


The following settings are available: 


Value Description Explanation 

0 left The selected column is aligned left. 

1 centered The selected column is aligned to center. 
2 right The selected column is aligned right. 


The attribute can be assigned dynamic properties by means of the name ColumnAlign. The 
data type is LONG. 


ColumnAutoPrecisions property 


Decimal places automatic - ColumnAutoPrecisions 


Enables automatic setting of the decimal precision. 


Value Explanation 
TRUE The decimal precision is defined automatically. The value in the "Decimal places" field is disabled. 
FALSE The value in the "Decimal places" field is enabled. 


The attribute can be assigned dynamic properties by means of the name 
ColumnAutoPrecisions. The data type is BOOLEAN. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 379 


VBS for Creating Procedures and Actions 
7.14 VBS Reference 


ColumnCaption property 


Caption - ColumnCaption 
Sets the caption for a selected column. 


The attribute can be assigned dynamic properties by means of the name ColumnCaption. The 
data type is STRING. 


ColumnCount property 


ColumnCount 
Defines the number of columns configured. 


The attribute can be assigned dynamic properties by means of the name ColumnCount. The 
data type is LONG. 


ColumnDateFormat property 
Date format - ColumnDateFormat 


Defines the date format for visualization. 


The following date formats are available: 


Value Explanation 

Automatic The date format is set automatically. 
dd.MM.yy Day.Month.Year, e.g. 24.12.07. 
dd.MM.yyyy Day.Month.Year, e.g. 24.12.2007. 
dd/MM/yy Day/Month/Year, e.g. 24/12/07. 
dd/MM/yyyy Day/Month/Year, e.g. 24/12/2007. 


The attribute can be assigned dynamic properties by means of the name ColumnDateFormat. 
The data type is STRING. 


ColumnDMVarName property 


ColumnDMVarName 
Defines the name of the tag you assigned to the column in the user archive. 


The attribute can be assigned dynamic properties by means of the name 
ColumnDMVarName. The data type is STRING. 
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ColumnExponentialFormat property 


Exponential notation - ColumnExponentialFormat 


Sets exponential notation for the display of values of a selected column. 


Value Explanation 
TRUE The values are displayed with exponential notation. 
FALSE The values are displayed with decimal notation. 


The attribute can be assigned dynamic properties by means of the name 
ColumnExponentialFormat. The data type is BOOLEAN. 


ColumnFlagNotNull property 
ColumnFlagNotNull 


Specifies whether the user archive field assigned to the column must have a value. 


Value Explanation 
Yes The column must have a value. 
No The column can have a value. 


The attribute cannot be dynamized. 


ColumnFlagUnique property 
ColumnFlagUnique 


Specifies whether the user archive field assigned to the column must have a unique value. 
Values in this column must not be redundant. 


Value Explanation 
TRUE The column must have a unique value. 
FALSE The column must not have a unique value. 


The attribute cannot be dynamized. 


ColumnHideText property 


Content as text - ColumnHideText 


Defines textual display of the contents of a selected column. 


Value Explanation 
TRUE The content is not displayed in text format. The option is disabled. 
FALSE The content is displayed in text format. The option is enabled. 


The attribute can be assigned dynamic properties by means of the name ColumnHideText. 
The data type is BOOLEAN. 
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ColumnHideTitleText property 


Text header - ColumnHideTitleText 
Sets textual display of the header of a selected column. 


Value Explanation 
TRUE The header is not displayed in text format. The option is disabled. 
FALSE The header is displayed in text format. The option is enabled. 


The attribute can be assigned dynamic properties by means of the name 
ColumnHideTitleText. The data type is BOOLEAN. 


Columnid property 


Columnld 
Default assignment of the ID number and column in the WinCC control: 


The attribute can be assigned dynamic properties by means of the name Columnld . The data 
type is LONG. 


Columnindex property 


Columnindex 
References a control column. Using this attribute you can assign the values of other properties 
to a specific column. 
Values between 0 and "ColumnCount" minus 1 are valid for "ColumnIndex"; the attribute 
"ColumnCount" defines the number of available columns. 


The "ColumnIndex" attribute can be assigned dynamic properties by means of attribute 
ColumnIndex. The data type is LONG. 


ColumnininspectorView property 


ColumninIinspectorView 
Specifies whether the diagnostic data in the detail view are displayed in columns instead of 
rows. 
The attribute can be assigned dynamic properties using the name ColumninInspectorView. 
The data type is BOOLEAN. 
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ColumnLeadingZeros property 


With leading zeros - ColumnLeadingZeros 


Enables the display of values with leading zeros for the column selected. Use "Number of 
digits" or "ColumnLeadingZeros" to specify the number of leading zeros. The maximum 
number is "11". No leading zeros are displayed with the value "0". The "With leading zeros" 
option is deactivated. 


The attribute can be assigned dynamic properties by means of the name 
ColumnLeadingZeros. The data type is LONG. 


ColumnLength property 


Length in Characters - ColumnLength 
Specifies the width of a selected column. 


The attribute can be assigned dynamic properties by means of the name ColumnLength. The 
data type is LONG. 


ColumnMaxValue property 


ColumnMaxValue 
Defines the maximum column value specified in the user archive. 


The attribute can be assigned dynamic properties by means of the name ColumnMaxValue. 
The data type is STRING. 


ColumnMinValue property 


ColumnMinValue 
Defines the minimum column value specified in the user archive. 


The attribute can be assigned dynamic properties by means of the name ColumnMinValue. 
The data type is STRING. 


ColumnName property 


ColumnName 
Defines the name of the column which is referenced by means of "Columnindex" attribute. 


The attribute can be assigned dynamic properties by means of the name ColumnName. The 
data type is STRING. 
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ColumnPosition property 


ColumnPosition 
Displays the field position defined in the user archive. 


The attribute can be assigned dynamic properties by means of the name ColumnPosition. The 
data type is LONG. 


ColumnPrecisions property 


Decimal places - ColumnPrecisions 


Specifies the number of decimal places of the values in the selected column. You can only 
enter the value if the "Automatic" option is disabled. 


The attribute can be assigned dynamic properties by means of the name ColumnPrecisions. 
The data type is SHORT. 


ColumnReadAccess property 
ColumnReadAccess 


Defines authorizations for read access to the column as specified in the user archive. The 
number corresponds with the number assigned to the authorization in the "User Administrator" 
editor. 


The attribute cannot be dynamized. 


ColumnReadonly property 


Write protected - ColumnReadonly 
Sets the write protection of a selected column. 


Value Explanation 

TRUE This column is write protected. 

FALSE This column is not write protected. You can edit the column values in Runtime by activating the "Change" 
option in the General" tab. 


The attribute can be assigned dynamic properties by means of the name ColumnReadonly. 
The data type is BOOLEAN. 


ColumnRemove property 


Remove - ColumnRemove 


Cuts selected columns from the list of selected columns and pastes these to the list of available 
columns. 
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The attribute can be assigned dynamic properties by means of the name ColumnRemove. The 
data type is STRING. 


ColumnRepos property 


Up/Down - ColumnRepos 


Changes the order of columns. "Up" and "Down" move the column selected up or down in the 
list. This moves the column towards the front or towards the back. 


The attribute can be assigned dynamic properties by means of the name ColumnRepos. The 
data type is LONG. 


ColumnResize property 


Width can be resized - ColumnResize 


Enables changes to the width of columns. 


Value Explanation 
TRUE You can change the width of the columns. 
FALSE You cannot change the width of the columns. 


The attribute can be assigned dynamic properties by means of the name ColumnResize. The 
data type is BOOLEAN. 


ColumnSrollbar properties 
Column scroll bars - ColumnScrollbar 


Enables the display of column scroll bars. 


The following settings are available: 


Value | Description Explanation 
0 no Column scroll bars are not displayed. 
1 as required Column scroll bars are displayed if vertical space requirements of the con- 


trol are greater than the actually available display area. 


2 always Column scroll bars are always displayed. 


The attribute can be assigned dynamic properties by means of the name ColumnScrollbar. 
The data type is LONG. 
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ColumnShowDate property 


Display date - ColumnShowDate 
Specifies if the "Time" block is displayed with time and date in a field. 


Value Explanation 


TRUE The date and time are displayed. The date format is defined in the "Date format" field. 
FALSE The time is displayed. 


The attribute can be assigned dynamic properties by means of the name ColumnShowDate. 
The data type is BOOLEAN. 


ColumnShowlcon property 
Content as icon - ColumnShowlcon 


Enables the display the contents of a selected column by means of icon. This function is only 
available in WinCC Alarm Control. 


Value Explanation 
TRUE The content is visualized as icon. 
FALSE The content is not visualized as icon. 


The attribute can be assigned dynamic properties by means of the name ColumnShowlcon. 
The data type is BOOLEAN. 


ColumnShowTitlelcon property 
Header as icon - ColumnShowTitlelcon 


Specifies the display of the header of a selected column by means of icon. This function is 
only available in WinCC Alarm Control. 


Value Explanation 
TRUE The header is displayed as icon. 
FALSE The header is not displayed as icon. 


The attribute can be assigned dynamic properties by means of the name 
ColumnShowTitlelcon. The data type is BOOLEAN. 


ColumnsMoveable property 


ColumnsMoveable 
Specifies whether the user can move the columns of the control in runtime. 


The attribute can be assigned dynamic properties using the name ColumnsMoveable. The 
data type is BOOLEAN. 
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ColumnSort property 


ColumnSort 
Defines the sorting order of the user archive column referenced in the "Columnindex" attribute. 


The following settings are available: 


Value Description Explanation 

0 No No sorting 

1 Ascending Ascending order, starting at the lowest value. 

2 Descending Descending order, starting at the highest value. 


The attribute can be assigned dynamic properties by means of the name ColumnSort . The 
data type is LONG. 


ColumnSortIndex property 


ColumnSortIndex 


Defines the sorting order of the column referenced in "Columnindex". The sorting criterion is 
removed from "ColumnSort" if you set a "0" value.. 


The attribute can be assigned dynamic properties by means of the name ColumnSortIndex. 
The data type is LONG. 


ColumnStartValue property 


ColumnStartValue 
Defines the column start value specified in the user archive. 


The attribute can be assigned dynamic properties by means of the name ColumnStartValue. 
The data type is STRING. 


ColumnStringLength property 


ColumnStringLength 
Displays the string length of the column as defined in the user archive. 


The attribute can be assigned dynamic properties by means of the name 
ColumnStringLength. The data type is LONG. 
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ColumnTimeFormat property 


Time format - ColumnTimeFormat 
Defines the time format to be used for visualization. 


The following time formats are available: 


Value Explanation 

Automatic The time format is set automatically. 

HH:mm:ss.ms Hours:Minutes:Seconds, e.g. 15:35:44.240. 

hh:mmiss tt Hours:Minutes:Seconds AM/PM, e.g. 03:35:44 PM. 

hh:mmi:ss.ms tt Hours:Minutes:Seconds.Milliseconds AM/PM, e.g. 03:35:44.240 PM. 


The attribute can be assigned dynamic properties by means of the name 
ColumnTimeFormat. The data type is STRING. 


ColumnTitleAlign property 
Column title alignment - ColumnTitleAlign 


Specifies the type of column title alignment. 


The following settings are available: 


Value Description Explanation 

0 left The column titles are left justified. 

1 centered The column titles are centered. 

2 right The column titles are right justified. 

3 Same as table The column titles are justified to fit the corresponding column content. 
content 


The attribute can be assigned dynamic properties by means of the name ColumnTitleAlign. 
The data type is LONG. 


ColumnTitles property 


Show column title - Column Titles 


Enables the display of the column header. 


Value Explanation 
TRUE The column header is displayed. 
FALSE The column header is not displayed. 


The attribute can be assigned dynamic properties by means of the name ColumnTitles. The 
data type is BOOLEAN. 
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ColumnType property 


Type - ColumnType 
Displays the data type set in the user archive for a selected column. 


The attribute can be assigned dynamic properties by means of the name ColumnType. The 
data type is LONG. 


ColumnType property 
ColumnType 


Indicates the associated view of the selected column in the SysDiagControl. 


The attribute can be assigned dynamic properties using the name ColumnType. The data type 


is LONG. 
ColumnVisible property 
ColumnVisible 
Enables the display of a column referenced by means of "Columnindex" attribute. 
Value Explanation 
TRUE The column is displayed. 
FALSE The column is not displayed. 


The attribute can be assigned dynamic properties by means of the name ColumnVisible . The 
data type is BOOLEAN. 


ColumnWriteAccess property 
ColumnWriteAccess 


Defines authorizations for write access to the column as specified in the user archive. The 
number corresponds with the number assigned to the authorization in the "User Administrator" 
editor. 


The attribute cannot be dynamized. 


ColWidth Property 


Description 


TRUE, when it should be possible to change the widths of the columns in the message window. 
The width of the columns can only be changed, however, when the "AutoScroll" property is 
not active. BOOLEAN write-read access. 
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See also 
WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 


Command Property 


Description 
TRUE, when updating of the values displayed in the control should be forced. 


See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
Screenltem Object (Page 125) 


Comment property 


Description 
Reads or sets the Alarm object comment. 


See also 
Alarms object (list) (Page 110) 


Common Time Property 


Description 


TRUE, when a common time column is to be used in the table window. BOOLEAN write-read 
access. 


See also 
WinCC Online Table Control (before WinCC V7) (Page 292) 
Screenltem Object (Page 125) 
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CommonxX Property 


Description 


TRUE, when the trends in the trend window should be displayed with a common X-axis. 
BOOLEAN write-read access. 


See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
CommonY Property 
Description 
TRUE, when the trends in the trend window should be displayed with a common Y-axis. 
BOOLEAN write-read access. 
See also 
Screenltem Object (Page 125) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
ComputerName property 
Description 
Returns the name of the computer on which the alarm object was triggered. 
ComputerName (readonly) 
See also 
Alarms object (list) (Page 110) 
Context property 
Description 


Reads or sets the alarm object server prefix. 
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See also 


Alarms object (list) (Page 110) 


ConnectBarWindows property 


Connected diagram window - ConnectBarWindows 


Specifies whether the configured diagram windows are connected. You must have configured 
several diagram windows for this. 


The connected diagram windows have the following properties: 
e They can have a common X axis. 
@ They have a scroll bar. 


e The zoom functions for a diagram window affect the connected diagram windows. 


Description 


TRUE All configured diagram windows are connected. 


FALSE | The diagram windows are displayed separately. 


The attribute can be assigned dynamic properties using the name ConnectBarWindows. The 
data type is BOOLEAN. 


ConnectTrendWindows property 


Connect trend windows - ConnectTrendWindows 


392 


Enables the connection of trend windows configured. You must have configured several trend 
windows. 


The connected trend windows have the following properties: 
e They can have a common X axis. 

@ They have a scroll bar. 

e They have a ruler. 


e The zoom functions for a trend window affect the connected trend windows. 


Value Description 


TRUE All trend windows configured are connected. 


FALSE | The trend windows are displayed separately. 


The attribute can be assigned dynamic properties by means of the name 
ConnectTrendWindows. The data type is BOOLEAN. 
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ContinousChange Property 


Description 
Defines the type of transfer of the value defined by the slider ("Position" property) in Runtime: 


@ FALSE : The value of the "Position" property is transferred when the mouse button is 
released. 


@ TRUE : The value of the "Position" property is transferred immediately following a change 
of the slider position. 


See also 
WinCC Slider Control (Page 277) 
Screenltem Object (Page 125) 
Count Property 
Description 
Supplies the number of elements in a list. 
INTEGER (read-only access). 
Example: 
The example shows how the number of objects in a DataSet list is output. 
'VBS165 
HMTIRuntime.Trace "Count: " & HMIRuntime.DataSet.Count & vbNewLine 
The following example adds two tags to the TagSet list and outputs the count properties as 
Trace. 
'VBS177 


Dim group 

Set group = HMIRuntime.Tags.CreateTagSet 

group.Add "Motor1" 

group.Add "Motor2" 

HMTIRuntime.Trace "Count: " & group.Count & vbNewLine 
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See also 
CreateTagSet Method (Page 717) 
TagSet Object (List) (Page 141) 
Screenltems Object (List) (Page 129) 
Screens Object (List) (Page 134) 
Layers Object (Listing) (Page 121) 
DataSet Object (List) (Page 116) 
ProcessValues Object (List) (Page 124) 


Count property 


Count 


Specifies the number of rows of the row listing object of a table control. 


Cu 


CurrentContext Property 


Description 


In the case of a picture window, the server from which the picture comes and contains the 
script is read out. 


The "CurrentContext" property can return different results: If, for example, a picture window 
displaying a server picture is set in a local basic picture, distinction is made between two cases: 


@ The "CurrentContext" property is used in an action of the picture window picture: The result 
is the return of the symbolic computer name of the server (Package property) extended by 
two colons, e.g."WinCCProject_MyComputer::" . 


e The"CurrentContext" property is used in an action of the basic picture: The result is returned 
in the form of an empty character string. 


See also 
HM Runtime Object (Page 118) 
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Cursor Property 
Description 
Controls the appearance of the cursor in Runtime when positioned over an icon. 
e 0: The cursor appears as an arrow and does not change when positioned over the icon. 
e 1: The cursor appears as a 3D arrow accompanied by a green lightening symbol. In 
Runtime, this indicates that the object concerned can be operated. 
See also 
Screenltem Object (Page 125) 
HMI Symbol Library (Page 239) 
Cursor property 
Mouse pointer (Cursor) 
Specifies whether or not to display the mouse pointer on the icon at runtime. 
Value Explanation 
TRUE The mouse pointer is shown at runtime if positioned on the icon. 


FALSE 


The mouse pointer is hidden at runtime if positioned on the icon. 


The attribute can be assigned dynamic properties by means of the name Cursor. The data 
type is BOOLEAN. 


CursorControl Property 


Description 


See also 


TRUE, when Alpha Cursor mode is activated, the cursor skips to the next field in the TAB 
sequence after exiting the field. BOOLEAN write-read access. 


To do this, the "CursorMode" property must be set to TRUE. 


Text list (Page 196) 
I/O Field (Page 184) 
Screenltem Object (Page 125) 
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CurveForm Property 


Description 


See also 


WinCC Function Trend Control 


Defines how the measuring points of a trend referenced by the "Index" property should be 
connected. Write/Read access. 


WinCC Online Trend Control 


The "Index" property references a trend. "CurveForm" defines how the measuring points 
should be connected. 


e 0x00000012 Representation of the measuring points. 

@ 0x00000014 Measuring points are connected linearly. 

@ 0x00000011 Measuring points are connected via a step curve. 

@ 0x00000021 The area under the linearly connected trend is filled. 
@ 0x00000022: The area under the step curve is filled. 


WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


CursorMode Property 


Description 


When the "CursorMode' is set to "yes", you can show all messages from the short-term archive 
page by page in the long-term archive list. Use the "CursorModePrefetch" property to 
determine the number of messages shown per page. 


The "Autoscroll" option must be unchecked in order to be able to switch between pages. Write/ 
Read access. 


CursorModePrefetch Property 


Description 


396 


Sets the number of message that you want to display page by page in the long-term archive 
list out of all messages in the short-term archive. 


The "CursorMode" object property must be set to "yes". 


Write/Read access. 
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1.14.4.5 D 

Da 

DangerColor Property 
Description 


Defines or returns the color of the danger zone on the scale. LONG write-read access. 


See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 
Danger Property 
Description 
Defines or returns the beginning of the "danger zone". The zone stretches from the "danger" 
value to the end of the scale. Write/Read access. 
See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 
DataFormat Property 
Description 


Returns the data type of the I/O field object. Read only access. 
Value range from 0 to 3. 

0: Binary 

1: Decimal 

2: String 


3: Hexadecimal 
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See also 
I/O Field (Page 184) 
Screenltem Object (Page 125) 
Datalndex Property 
Description 
Returns the current index of the data of the current trend. 
Note 
The property is only supported for the controls prior to WinCC V7. 
See also 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


DataLogs Property 


Description 
Returns an object of type "DataLogs". 
DataLogs (read-only) 
See also 
DataLogs Object (Page 114) 
HM IRuntime Object (Page 118) 
DataSet Property 
Description 


Returns an object of type "DataSet". 


DataSet (read-only) 
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See also 


DataX Property 


Description 


See also 


DataXY Property 


Description 


See also 
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DataSet Object (List) (Page 116) 
HM IRuntime Object (Page 118) 


Inserts a single data record and must be set before calling "InsertData". 


Note 
The property is only supported for the controls prior to WinCC V7. 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


Inserts several data records as an array with pairs of values and must be set before calling 
"InsertData". 


The data in the array is assumed when "DataxX" is of the VT_EMPTY type. Otherwise, the 
"InsertData" attribute used the single value pair resulting from “Datax” and “DataY”. 


Note 
The property is only supported for the controls prior to WinCC V7. 


Example: Calling Methods of an ActiveX Control (Page 841) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
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DataY Property 

Description 
Inserts a single data record and must be set before calling "InsertData". 
Note 
The property is only supported for the controls prior to WinCC V7. 

See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 

De - Do 


DefaultMsgFilterSQL property 


DefaultMsgFilterSQL 
Defines an SQL statement for a fixed selection of messages. 


The SQL statements of "DefaultMsgFilterSQL" and "MsgFilterSQL" are linked logically by 
"AND" operation if you define additional custom selections by means of "MsgFilterSQL" 
attribute. 


The attribute can be assigned dynamic properties by means of the name 
DefaultMsgFilterSQL. The data type is STRING. 


DefaultPrecision Property 


Description 


This attribute defines the number of default decimal places, with which the scale value is 
specified. Write/Read access. 


DefaultRulerPrecision Property 


Description 


This attribute defines the number of decimal places as standard value with which a measured 
value should be displayed when it is determined using the "Display value at this position" 
function. Write/Read access. 
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Default sorting order - DefaultSort 


Defines the default sorting order in table columns. 


The following settings are available: 


7.14 VBS Reference 


Value Description Explanation 
0 Ascending The list is updated starting with the bottom line. 
1 Descending The list is updated starting with the top line. 


The attribute can be assigned dynamic properties by means of the name DefaultSort. The data 


type is LONG. 


DefaultSort2 property 


DefaultSort2 

Use this function to define the sorting method in table columns if not using the default "Date/ 
time/number" sorting order. Instead, you defined a message block in the "DefaultSort2Column" 
object property to sort the columns based on the "message block/date/time/number" order. 
The following settings are available: 

Value Description Explanation 

0 Ascending The list is updated starting with the bottom line. 

1 Descending The list is updated starting with the top line. 


DefaultSort2Column property 


The attribute can be assigned dynamic properties by means of the name DefaultSort2. The 
data type is LONG. 


DefaultSort2Column 
Use this function to define the sorting method in table columns if not using the default "Date/ 
time/number" sorting order. 
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The table columns are now sorted based on the "message block/date/time/number" order. 


The attribute can be assigned dynamic properties by means of the name 
DefaultSort2Column. The data type is STRING. 
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DeleteData Property 


Description 


See also 


Delta Property 


Deletes data in the data buffer of the current trend. 
TRUE : All trend data is deleted. 


FALSE : The value pair at the "Datalndex" position are deleted. 


Note 
The property is only supported for the controls prior to WinCC V7. 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


Description 
Defines or returns the value difference between two main scale graduation marks. Write/Read 
access. 
See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 
DesiredCurveColor Property 
Description 
Defines the color of a setpoint trend which belongs to a trend referenced by the "Index" 
property. The color is defined as an RGB value. Whether the information is evaluated is 
dependent on the value of the "DesiredCurvevVisible" property. 
See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
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DesiredCurveCurveForm Property 


Description 


See also 


Defines the form of representation of a setpoint trend which belongs to a trend referenced by 
the "Index" property. Whether the information is evaluated is dependent on the value of the 
"DesiredCurveVisible" property. 


0x00000011 Measuring points are connected by a solid line via a step curve 
0x00000012 Representation of the measuring points 

0x00000014 Measuring points are connected linearly with a solid line 
0x00000021 The area under the linearly connected trend is filled. 

0x00000022: The area under the stepped curve is filled. 

0x00000031: Measuring points are connected by a dashed line via a step curve 


0x00000032: Measuring points are connected linearly with a dashed line 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


DesiredCurveSourceNumberOfUAValues Property 


Description 


See also 


Defines the number of value pairs of a setpoint trend which belongs to a trend referenced by 
the "Index" property. Whether the information is evaluated is dependent on the value of the 
"DesiredCurveVisible" property. 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


DesiredCurveSourceUAArchive Property 


Description 


Defines the name of the user archive from which the value of a setpoint trend, which belongs 
to a trend referenced by "Index", is read. Whether the information is evaluated is dependent 
on the value of the "DesiredCurveVisible" property. 
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See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


DesiredCurveSourceUAArchiveStartID Property 


Description 
Defines the starting point for the value of a setpoint trend, which belongs to a trend referenced 
by "Index", from which the values should be read from the archive. Whether the information is 
evaluated is dependent on the value of the "DesiredCurveVisible" property. 

See also 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


DesiredCurveSourceUAColumnX Property 


Description 
Defines the column in the user archive from which the X-values of a setpoint trend, which 
belongs to a trend referenced by "Index", should be read. Whether the information is evaluated 
is dependent on the value of the "DesiredCurveVisible" property. 

See also 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


DesiredCurveSourceUAColumnyY Property 


Description 
Defines the column in the user archive from which the Y-values of a setpoint trend, which 
belongs to a trend referenced by "Index", should be read. Whether the information is evaluated 
is dependent on the value of the "DesiredCurveVisible" property. 

See also 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
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DesiredCurveVisible Property 


Description 


TRUE, a setpoint trend which belongs to a trend referenced by "Index" should be displayed. 
BOOLEAN write-read access. 


See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 


Screenltem Object (Page 125) 


Direction Property 


Description 
Defines or returns the bar direction or the position of the slider object. BOOLEAN write-read 
access. Value range from 0 to 3. 
0 = top 
1 = bottom 
2 = left 
3 = right 
See also 
Slider (Page 212) 
Bar (Page 174) 
3D Bar (Page 169) 
Screenltem Object (Page 125) 
DisplayName property 
Display name (DisplayName) 
Specifies the user-defined name of the process picture. The attribute is of type "Multilingual 
String". You can specify names for all languages installed in WinCC. 
The logon name is displayed in the following cases: 
WinCC Explorer "Details" view in the data window "Display name" column 
"Large Icons" view in the data window Process picture preview 
WinCC Runtime "Favorites" system dialog Process picture preview 


The "Display name" attribute can be dynamized with the "DisplayName" name. 
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DisplayOptions property 


Show messages - DisplayOptions 
Select the messages to be displayed. 


The following selection options are available: 


Value Designation 

0 All messages 

1 Only displayed messages 
2 Only hidden messages 


The attribute can be assigned dynamic properties by means of the name DisplayOptions. The 
data type is LONG. 


DisplayOptions property (before WinCC V7) 


Description 


Specifies if a button is assigned to a graphic, text, or both. 


0 


Picture or text: If a picture exists, the button is assigned with the picture, otherwise it is 
assigned with text. 


Graphic and text 
Text only 
Graphic only 


DoubleClickAction property 


Action on double-click - DoubleClickAction 
Sepcifies the action to be executed in Runtime by double-clicking on a message line. 


The following settings are available: 


Description Explanation 
0 none No action. 
1 Loop-in-alarm Calls the "Loop-in-alarm" function. 
2 Open comments dialog Calls the "Comments dialog" button function. 
3 Open Infotext dialog Calls the "Infotext dialog" button function. 
4 Column-dependent The action is determined by the column in which you dou- 
ble-clicked. 


The attribute can be assigned dynamic properties by means of the name DoubleClickAction. 
The data type is LONG. 
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1.14.4.6 
Edit Property 
Description 
Activates Editing mode for a cell as long as the "Editable" property has been set to TRUE for 
the corresponding column. 
See also 
WinCC Online Table Control (before WinCC V7) (Page 292) 
Screenltem Object (Page 125) 
Editable Property 
Description 
The "Index" property references a pair of columns. "Editable" defines whether the column pair 
should be editable. BOOLEAN write-read access. 
See also 
WinCC Online Table Control (before WinCC V7) (Page 292) 
Screenltem Object (Page 125) 
EditAtOnce Property 
Description 
TRUE, if accessing the field with the <TAB> key permits input immediately and without further 
action. BOOLEAN write-read access. 
See also 


Text list (Page 196) 
I/O Field (Page 184) 
Screenltem Object (Page 125) 
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Enabled Property 


Function 
Enables or disables possible operation of an object or issues the corresponding value. TRUE : 
Enable operation, FALSE: Operation is disabled. 
BOOLEAN write-read access. 
Example: 
The following example disables all objects in the picture "NewPDL1": 
'VBS71 


Dim objScreen 

Dim objScriItem 

Dim lngIndex 

Dim strName 

IngIndex = 1 

Set objScreen = HMITRuntime.Screens ("NewPDL1") 
For IngIndex = 1 To objScreen.ScreenItems.Count 


strName = objScreen.ScreenItems.Item(lngIndex) .ObjectNam 
Set objScrItem = objScreen.ScreenItems (strName) 
objScritem.Enabled=False "Lock object 

Next 


See also 
Screen Object (Page 131) 
Screenltem Object (Page 125) 


EnableDelete property 


Delete - EnableDelete 


"Read names of objects 


Enables deletion of data from the user archive in Runtime. 


Value Explanation 
TRUE You can delete data from the user archive in Runtime. 
FALSE You cannot delete data from the user archive in Runtime. 


The attribute can be assigned dynamic properties by means of the name EnableDelete. The 


data type is BOOLEAN. 
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EnableEdit property 


Modify - EnableEdit 


Enables editing of the data displayed during runtime. 


Value Explanation 
TRUE Enables editing of data during runtime. 
FALSE Disables editing of data during runtime. 


The attribute can be assigned dynamic properties by means of the name EnableEdit. The data 
type is BOOLEAN. 


Enablelnsert property 


Add - Enablelnsert 


Enables insertion of data in the user archive in Runtime. 


Value Explanation 
TRUE You can add data to the user archive in Runtime. 
FALSE You cannot add data to the user archive in Runtime. 


The attribute can be assigned dynamic properties by means of the name Enablelnsert. The 
data type is BOOLEAN. 


EnablePopupMenu property 


EnablePopupMenu 
Specifies if the pop-up menu is enabled in the control. 


The attribute can be assigned dynamic properties by means of the name EnablePopupMenu. 
The data type is BOOLEAN. 


EndAngle Property 


Description 


Defines or returns the end of the object. The information is in counterclockwise direction in 
degrees, beginning at the 12:00 clock position. 


See also 
Pie segment (Page 152) 
Circular arc (Page 151) 
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Ellipse segment (Page 147) 
Ellipse arc (Page 146) 
Screenltem Object (Page 125) 


EndTime Property 


Description 


Online Table Control 


The "Index" attribute references a pair of columns. "EndTime" defines the end time for 
displaying this column pair. Whether the information is evaluated is dependent on the 
TimeRange" and "CommonTime" properties. Write/Read access. 


Online Trend Control 


The "Index" attribute references a trend. "EndTime" defines the end time for displaying this 
trend. Whether the information is evaluated is dependent on the "Autorange", "TimeRange" 
and "Commonx" properties. 


Use the "yyyy-mm-dd hh:mm:ss" format when creating a dynamic time range. 


See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
Screenltem Object (Page 125) 
EndValue Property 
Description 
The "Index" property references a trend. "EndValue" defines the upper limit of the value range 
to be displayed for the trend. Whether the information is evaluated is dependent on the 
"Autorange" and "CommonyY" properties. 
See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 
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EndX Property 


Description 


See also 


EndY Property 


Description 


See also 


ErrorDescription 


Function 
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Defines the upper limit of the X-axis of a trend referenced with "Index". Whether the information 
is evaluated is dependent on the "AutorangeX" and "CommonxX" properties. 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


Defines the upper limit of the Y-axis of a trend referenced with "Index". Whether the information 
is evaluated is dependent on the "AutorangeY" and "CommonyY" properties. 


WinCC Function Trend Control (before WinCC V7) (Page 288) 


Screenltem Object (Page 125) 


Property 


Error description of the "LastError" property. The error description is provided in English only. 
STRING (read only) 


The following error messages are defined: 


Output Description 

me OK 

"Operation Failed" Execution error 

"Variable not found" Tag error 

"Server down" Server not available. 

"An error occured for one or several tags" Multi Tag Error (Error in one or several tags) 


In order that ErrorDescription returns a value, a read process must be executed beforehand. 


If an error occurs during read or write of several tags using the TagSet object, the error is set 
to "Multi Tag Error". In order to determine at which tag the error occurred and what type of 
error it was, the ErrorDescription property of each tag must be analyzed. 
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Example: 
The following example displays the error description for "Tag1": 


"VBS72 

Dim objTag 

Set objTag = HMIRuntime.Tags ("Tagl") 
objtag.Read 
MsgBox objTag.ErrorDescription 


The following example adds two tags to the TagSet list and outputs the ErrorDescription 
property as Trace. 


"VBS179 

Dim group 

Set group = HMIRuntime.Tags.CreateTagSet 

group.Add "Motor1" 

group.Add "Motor2" 

HMIRuntime.Trace "ErrorDescription: " & group.ErrorDescription & vbNewLine 


The ErrorDescription property of a tag contained in the list may be accessed as follows: 


HMIRuntime.Trace "ErrorDescription: " & group("Motorl1").ErrorDescription & vbNewLine 


See also 
LastError Property (Page 459) 


QualityCode Property (Page 546) 
TagSet Object (List) (Page 141) 
Tag Object (Page 137) 


Exponent Property 


Description 
TRUE, when the display of numbers should be with exponents (e.g."1.00e+000"). BOOLEAN 
write-read access. 


See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
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ExportDirectoryChangeable property 
Directory can be changed - ExportDirectoryChangeable 
Enables changing of the directory for data export in Runtime. 


Value Explanation 
TRUE The data export directory can be changed in Runtime. 


FALSE The data export directory cannot be changed in Runtime. 


The attribute can be assigned dynamic properties by means of the name 
ExportDirectoryChangeable. The data type is BOOLEAN. 


ExportDirectoryname property 


Directory - ExportDirectoryname 
Defines the directory to which the exported Runtime data is written. 
You can select or create the directory using the selection button. 


The attribute can be assigned dynamic properties by means of the name 
ExportDirectoryname. The data type is STRING. 


ExportFileExtension property 
ExportFileExtension 
Defines the extension of the export file. 


Only the file name extension "csv" is currently supported. 


The attribute can be assigned dynamic properties by means of the name 
ExportFileExtension. The data type is STRING. 


ExportFilename property 


File name - ExportFilename 


Defines the name of the file which is to receive the exported Runtime data. 


The attribute can be assigned dynamic properties by means of the name ExportFilename. The 


data type is STRING. 
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ExportFilenameChangeable property 


File can be renamed - ExportFilenameChangeable 


Enables renaming of the export file in Runtime. 


Explanation 
TRUE The export file can be renamed in Runtime. 
FALSE The export file cannot be renamed in Runtime. 


The attribute can be assigned dynamic properties by means of the name 
ExportFilenameChangeable. The data type is BOOLEAN. 


ExportFormatGuid property 


ExportFormatGuid 
Default assignment of the ID number and export provider. 


The attribute can be assigned dynamic properties by means of the name ExportFormatGuid. 
The data type is STRING. 


ExportFormatName property 


Format - ExportFormatName 
Defines the export file format. 
Only the "csv" file format is currently available for the export. 


The attribute can be assigned dynamic properties by means of the name ExportFormatName. 
The data type is STRING. 


ExportParameters property 
ExportParameters 


Specifies the parameters of the selected format by means of the properties dialog. 


The attribute can be assigned dynamic properties by means of the name ExportParameters. 
The data type is VARIANT. 


ExportSelection property 


Scope of data export - ExportSelection 
Specifies the control's Runtime data to be exported. 
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The following settings are available: 


Description Explanation 
0 all All Runtime data of the control is exported. 
1 Selection Selected Runtime data of the control is exported. 


The attribute can be assigned dynamic properties by means of the name ExportSelection. The 
data type is LONG. 


ExportShowDialog property 


Show dialog - ExportShowDialog 


Enables the display of the export dialog during runtime. 


Value Explanation 
TRUE The dialog is displayed during runtime. 


FALSE The dialog is not displayed during runtime. 


The attribute can be assigned dynamic properties by means of the name ExportShowDialog. 
The data type is BOOLEAN. 


ExportXML property 
ExportXML 
Only used internally. 


The attribute can be assigned dynamic properties by means of the name ExportXML. 


ExtendedOperation Property 


Description 
TRUE, when the slider regulator is set at the respective end value (minimum/maximum value). 
This is done by clicking the mouse in an area outside the current regulator setting. BOOLEAN 
write-read access. 

See also 


Slider (Page 212) 
Screenltem Object (Page 125) 
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ExtendedZoomingEnable Property 


Description 
Activates/deactivates the ExtendedZooming properties of a picture. 
Using ExtendedZooming, the view of a process picture in Runtime may be enlarged or reduced 
by using the mouse wheel. 
BOOLEAN write-read access. 

Example: 
Activates ExtendedZooming for picture NewPDL1. 

"'VBS155 


Dim objScreen 
Set objScreen = HMIRuntime.Screens ("NewPDL1") 
objScreen.ExtendedZoomingEnable = 1 


See also 
Screen Object (Page 131) 


1.14.4.7 F 


Fe - Fl 


FeatureFullscreen property 


FeatureFullscreen 


Specifies if the "Full screen" function is available in the control. 


The attribute can be assigned dynamic properties by means of the name FeatureFullscreen. 
The data type is BOOLEAN. 


FeaturePause property 


FeaturePause 
Specifies if the "Pause" function is available in the control. 


The attribute can be assigned dynamic properties by means of the name FeaturePause. The 
data type is BOOLEAN. 
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FeaturePlay property 


FeaturePlay 
Specifies if the "Play" function is available in the control. 


The attribute can be assigned dynamic properties by means of the name FeaturePlay. The 
data type is BOOLEAN. 


FeatureStepBackward property 


FeatureStepBackward 
Specifies if the "Step backward" function is available in the control. 


The attribute can be assigned dynamic properties by means of the name 
FeatureStepBackward. The data type is BOOLEAN. 


FeatureStepForward property 


FeatureStepForward 
Specifies if the "Step forward" function is available in the control. 


The attribute can be assigned dynamic properties by means of the name 
FeatureStepForward. The data type is BOOLEAN. 


FeatureStop property 


FeatureStop 
Specifies if the "Stop" function is available in the control. 


The attribute can be assigned dynamic properties by means of the name FeatureStop. The 
data type is BOOLEAN. 


FeatureVolume property 


FeatureVolume 
Specifies if the "Volume" function is available in the control. 


The attribute can be assigned dynamic properties by means of the name FeatureVolume. The 
data type is BOOLEAN. 
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FileName property 


FileName 
Specifies the file whose content you want to display or play. 


The attribute can be assigned dynamic properties by means of the name FileName. The data 
type is STRING. 


FillColor Property 


Description 
Defines or returns the fill pattern color for the object. 


LONG (write-read access) 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Enter the appropriate decimal value 
for each of the three RGB values. 


Example: 
RGB(200, 150, 100) 


Example: 
The following example defines the fill color for "ScreenWindow1" to blue: 


"VBS73 

Dim objScreen 

Set objScreen = HMITRuntime.Screens ("ScreenWindowl1") 
objScreen.FillStyle = 131075 

objScreen.FillColor = RGB(0O, 0, 255) 


See also 
FillStyle Property (Page 419) 
BackColor Property (Page 322) 
Screenltem Object (Page 125) 
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Filling Property 

Description 
TRUE, when the object can be filled by closed border lines (e.g. representing the fill level of a 
tank). BOOLEAN write-read access. 
The fill level of the object is set by means of the "Fillinglndex" property. 

See also 


Screenltem Object (Page 125) 


FillingDirection properties 
Filling direction (FillingDirection) 
The "Filling direction" attribute specifies the filling direction for an object enclosed in a frame 


line. 
Bottom to top The object is filled from bottom to top. 
Top to bottom The object is filled from top to bottom. 
Left to right The object is filled from left to right. 
Right to left The object is filled from right to left. 


The attribute can be assigned dynamic properties by means of the name FillingDirection. The 
data type is LONG. 


FillingIndex Property 


Description 
Defines the %age value (related to the height of the object) to which the object with closed 
border line is to be filled. 
The fill level is represented by the current background color. The unfilled background is 
transparent. 

See also 


Screenltem Object (Page 125) 


FillStyle Property 


Description 
Defines or returns the fill pattern for the object. 
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420 


LONG (write-read access) 


Fill pattern 
€ Transparent > 


Fill pattern 


Fill pattern 


Massy = > 


ty 


1048576 196611 196627 
1048577 196612 196628 
1048578 196613 196629 
1048579 196614 196630 


1048832 


1048833 


196615 


196616 


196631 


196632 


EMU VUC a ae 


1048834 196617 eee 196633 
eceomeremrr 

1048835 196618 atetetateteten 196634 
RS 

131072 196619 196635 

131073 196620 196636 


131074 196621 196637 
131075 196622 196638 
LLL 
131076 196623 196639 
196608 196624 196640 
196609 196625 196641 
196610 196626 196642 
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The following example sets the fill pattern for "ScreenWindow1" to transparent: 


"VBS190 

Dim obj 

Set obj = ScreenItems("Rectanglel") 
obj.FillStyle = 65536 


See also 
FillColor Property (Page 418) 


BackColor Property (Page 322) 
Screen Object (Page 131) 


FillStyle2 Property 


Description 


Defines or returns the fill style of the bar. 


See also 
Bar (Page 174) 
Screenltem Object (Page 125) 


FillStyleAlignment property 


Description 


Defines the alignment of the fill pattern for the process picture. 


Normal The fill pattern refers to the process picture. In runtime, no scaling is 
performed when opening the picture. 

Stretched (window) The fill pattern refers to the window in the Graphics Designer. In runtime, 
scaling is performed when opening the picture. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 


421 


VBS for Creating Procedures and Actions 
7.14 VBS Reference 


FilterSQL property 


FilterSQL 
Defines an SQL statement for a selection of data in the user archive. 


The attribute can be assigned dynamic properties by means of the name FilterSQL. The data 
type is STRING. 


FineGrid Property 


Description 
TRUE, when the value axis is scaled by short tick marks. The distance between two short tick 
marks can be changed using the "FineGridValue" property. BOOLEAN write-read access. 
See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 
FineGridValue Property 
Description 
Defines the distance between two short tick marks in the scale. Whether the information is 
evaluated is dependent on the value of the "FineGrid" property. 
See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 
FineGridValueX Property 
Description 
Defines the distance between two short tick marks on the X-axes scaling. Whether the 
information is evaluated is dependent on the value of the "FineGridX" property. 
See also 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
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FineGridValueY Property 


Description 


Defines the distance between two short tick marks on the Y-axes scaling. Whether the 
information is evaluated is dependent on the value of the "FineGridX" property. 


See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
FineGridX Property 
Description 
TRUE, when the X-axis graduation is scaled by short tick marks. The distance between two 
short tick marks can be changed using the "FineGridValueX" property. 
See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
FineGridY Property 
Description 
TRUE, when the Y-axis graduation is scaled by short tick marks. The distance between two 
short tick marks can be changed using the "FineGridValueY" property. 
See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
FlashBackColor Property 
Description 


TRUE, when flashing of the background is activated. BOOLEAN write-read access 
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See also 
Screenltem Object (Page 125) 
FlashBorderColor Property 
Description 
TRUE, when flashing of the object lines is activated. BOOLEAN write-read access. 
See also 
Screenltem Object (Page 125) 
FlashFlashPicture Property 
Description 
TRUE, when flashing of the flash picture is activated. BOOLEAN write-read access. 
See also 
Status display (Page 199) 
Screenltem Object (Page 125) 
FlashForeColor Property 
Description 
TRUE, when flashing of the text is activated. BOOLEAN write-read access. 
See also 


I/O Field (Page 184) 

Static text (Page 165) 

Text list (Page 196) 

Radio box (Page 207) 

Check box (Page 204) 

Button (Page 201) 

Screenltem Object (Page 125) 
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FlashPicReferenced Property 


Description 


See also 


TRUE, when the assigned flash picture should be saved. Otherwise, only the associated object 
reference is saved. Read only access. 


Status display (Page 199) 
Screenltem Object (Page 125) 


FlashPicTransColor Property 


Description 


See also 


Defines which color of the bitmap object (.bmp, .dib) assigned to the flash picture should be 
set to "transparent". LONG Write/Read Access. 

The color is only set to "Transparent" if the value of the "FlashPicUseTransColor" property is 
"True". 


Screenltem Object (Page 125) 
Status display (Page 199) 


FlashPicture Property 


Description 


See also 


Returns the flash picture. Read-only access. 

The picture (*.BMP or *.DIB) must be located in the "GraCS" directory of the current project 
so that it can be integrated. 

In this context, the "FlashPicReferenced" property defines whether the flash picture should be 
saved together with the object status display or referenced. 


Status display (Page 199) 
Screenltem Object (Page 125) 
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FlashPicUseTransColor Property 


Description 
TRUE, when the configured color ("FlashPicTransColor" property) of the bitmap objects 
assigned to the flash picture should be set to "transparent". BOOLEAN write-read access. 
See also 
Status display (Page 199) 
Screenltem Object (Page 125) 
FlashRate Property 
Description 
Defines or returns the flashing frequency for the object. Value range from 0 to 2. 
Flash frequency Assigned Value 
Slow (approx. 0.25 Hz) 0 
Medium (approx. 0.5 Hz) 1 
Fast (approx. 1 Hz) 2 
Note 
Because the flashing is performed by means of software engineering, the flash frequency is 
both system-dependent and hardware-bound (number of objects, processor speed, RAM size, 
update time, etc.). 
The information in the table is therefore only for orientation purposes. 
See also 
Group Display (Page 194) 
Screenltem Object (Page 125) 
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FlashRateBackColor Property 


Description 
Defines or returns the flash frequency for the object background. Value range from 0 to 2. 
Flash frequency Assigned Value 
Slow (approx. 0.25 Hz) 0 
Medium (approx. 0.5 Hz) 1 
Fast (approx. 1 Hz) 2 
Note 
Because the flashing is performed by means of software engineering, the flash frequency is 
both system-dependent and hardware-bound (number of objects, processor speed, RAM size, 
update time, etc.). 
The information in the table is therefore only for orientation purposes. 
See also 


Screenltem Object (Page 125) 


FlashRateBorderColor Property 


Description 
Defines or returns the flash frequency for the lines of the object. Value range from 0 to 2. 
Flash frequency Assigned Value 
Slow (approx. 0.25 Hz) 0 
Medium (approx. 0.5 Hz) 1 
Fast (approx. 1 Hz) 2 
Note 
Because the flashing is performed by means of software engineering, the flash frequency is 
both system-dependent and hardware-bound (number of objects, processor speed, RAM size, 
update time, etc.). 
The information in the table is therefore only for orientation purposes. 
See also 


Screenltem Object (Page 125) 
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FlashRateFlashPic Property 


Description 
Defines or returns the flash frequency for the status display. Value range from 0 to 2. 
Flash frequency Assigned Value 
Slow (approx. 0.25 Hz) 0 
Medium (approx. 0.5 Hz) 1 
Fast (approx. 1 Hz) 2 
Note 
Because the flashing is performed by means of software engineering, the flash frequency is 
both system-dependent and hardware-bound (number of objects, processor speed, RAM size, 
update time, etc.). 
The information in the table is therefore only for orientation purposes. 
See also 


Status display (Page 199) 
Screenltem Object (Page 125) 


FlashRateForeColor Property 


Description 


Defines or returns the flash frequency for the object label. Value range from 0 to 2. 


Flash frequency Assigned Value 
Slow (approx. 0.5 Hz) 

Medium (approx. 2 Hz) 1 

Fast (approx. 8 Hz) 2 

Note 


Because the flashing is performed by means of software engineering, the flash frequency is 
both system-dependent and hardware-bound (number of objects, processor speed, RAM size, 
update time, etc.). 


The information in the table is therefore only for orientation purposes. 
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See also 
Static text (Page 165) 
Text list (Page 196) 
Radio box (Page 207) 
Check box (Page 204) 
Button (Page 201) 
I/O Field (Page 184) 
Screenltem Object (Page 125) 


Flip property 


Flip (Flip) 
Specifies flipping of the icon at runtime. 


The following settings are available: 


Value Description Comments 


0 None The icon is not flipped. 


Horizontal The object is flipped along the horizontal center axis. 


1 
2 Vertical The object is flipped along the vertical center axis. 
3 Both The object is flipped along the horizontal and vertical center axes. 


The attribute can be assigned dynamic properties by means of the name Flip. The data type 
is LONG. 


Flip Property 


Description 
Mirrors the icon on the vertical and/or horizontal middle axis of the icon. 
e Zero - 0: The icon is mot mirrored. 
e Horizontal - 1: The icon is mirrored on the vertical center axis. 
e Vertical - 2: The icon is mirrored on the horizontal, center axis. 


e Both - 3: The icon is mirrored both on the horizontal and vertical center axes. 


See also 
HMI Symbol Library (Page 239) 
Screenltem Object (Page 125) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 429 


VBS for Creating Procedures and Actions 


7.14 VBS Reference 


Fo-Fr 

FocusColor Property 

Description 
If the focus is positioned on the control in Runtime, the labeling and position text are identified 
by a border. FocusColor defines the color of the border. 

See also 
WinCC Slider Control (Page 277) 
Screenltem Object (Page 125) 

FocusRect Property 

Description 
TRUE, when the button should be provided with a selection border, in Runtime, as soon as it 
receives the focus. BOOLEAN write-read access. 

See also 


WinCC Push Button Control (Page 269) 
WinCC Digital/Analog Clock (Page 246) 
Screenltem Object (Page 125) 


FocusWidth Property 


Description 


See also 


430 


If the focus is positioned on the control in Runtime, the labeling and position text are identified 
by a border. FocusWidth defines the width of the border, value range of 1-10 pixels. LONG 
write-read access. 


WinCC Slider Control (Page 277) 
Screenltem Object (Page 125) 
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Font Property 


Name - Font 
Sets the font. 


The attribute cannot be dynamized. 


Font property (before WinCC V7) 


Description 
Defines or returns the font. Write/Read access. 
The font object has the following sub-properties 
@ Size (Font Size) 
@ Bold (yes/no) 
e Name (font name) 
e Italic (yes/no) 
e Underline (underline yes/no) 
e StrikeThrough (yes/no) 


If two font properties are directly assigned, only the default property "Name" is assumed. 


Example: 


"VBS74 

Dim objControll 

Dim objControl2 

Set objControll = ScreenItems("Controll") 

Set objControl2 = ScreenItems ("Control2") 

objControl2.Font = objControll.Font ' take over only the type of font 


See also 
WinCC Slider Control (Page 277) 
WinCC Push Button Control (Page 269) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
WinCC Digital/Analog Clock (Page 246) 
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WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 


FontBold Property 


Description 


See also 


TRUE, when the text in the object should be assigned the "bold" attribute. BOOLEAN write- 
read access. 


WinCC Push Button Control (Page 269) 
Group Display (Page 194) 

Text list (Page 196) 

Radio box (Page 207) 

Check box (Page 204) 

Button (Page 201) 

I/O Field (Page 184) 

Bar (Page 174) 

Screenltem Object (Page 125) 


Fontltalic Property 


Description 


See also 
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TRUE, when the text in the object should be assigned the "italic" attribute. BOOLEAN write- 
read access. 


WinCC Push Button Control (Page 269) 
Group Display (Page 194) 

Static text (Page 165) 

Text list (Page 196) 

Radio box (Page 207) 

Check box (Page 204) 

Button (Page 201) 

I/O Field (Page 184) 

Screenltem Object (Page 125) 
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Description 


See also 


Defines or returns the font name of the text in the object. 


All the fonts installed in Windows are available for selection. 


WinCC Push Button Control (Page 269) 
Group Display (Page 194) 

Static text (Page 165) 

Text list (Page 196) 

Radio box (Page 207) 

Check box (Page 204) 

Button (Page 201) 

I/O Field (Page 184) 

Bar (Page 174) 

Screenltem Object (Page 125) 


FontPosition Property 


7.14 VBS Reference 


Description 
Returns the font name for the display of the slider position in the bottom part of the object. All 
the fonts installed in Windows are available for selection. Read only access. 
See also 
WinCC Slider Control (Page 277) 
Screenltem Object (Page 125) 
FontSize Property 
Description 
Defines or returns the font size of the text in the object in points. 
See also 


WinCC Push Button Control (Page 269) 
Group Display (Page 194) 
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Static text (Page 165) 

Text list (Page 196) 

Radio box (Page 207) 

Check box (Page 204) 

Button (Page 201) 

I/O Field (Page 184) 

Bar (Page 174) 

Screenltem Object (Page 125) 


FontStrikeThru Property 


Description 


TRUE, when the text in the object should be assigned the "strikethrough" attribute. BOOLEAN 
write-read access. 


See also 
WinCC Push Button Control (Page 269) 
Screenltem Object (Page 125) 


FontUnderline Property 


Description 


TRUE, when the text in the object should be assigned the "underline" attribute. BOOLEAN 
write-read access. 


See also 
WinCC Push Button Control (Page 269) 
Group Display (Page 194) 
Static text (Page 165) 
Text list (Page 196) 
Radio box (Page 207) 
Check box (Page 204) 
Button (Page 201) 
I/O Field (Page 184) 
Screenltem Object (Page 125) 
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ForeColor Property 


Description 


Defines or returns the color of the font for the text in the object. LONG write-read access. 


See also 
WinCC Slider Control (Page 277) 
WinCC Push Button Control (Page 269) 
WinCC Digital/Analog Clock (Page 246) 
HMI Symbol Library (Page 239) 
Static text (Page 165) 
Text list (Page 196) 
Radio box (Page 207) 
Check box (Page 204) 
Button (Page 201) 
I/O Field (Page 184) 
Screenltem Object (Page 125) 


ForeColor property 


Foreground color (ForeColor) 


Specifies the foreground color of the icon in the "Color selection" dialog. The icon is displayed 
in the foreground color if the "Shadow" and "Solid" foreground mode is set. 


The attribute can be assigned dynamic properties by means of the name ForeColor. The data 
type is LONG. 


ForeFlashColorOff Property 


Description 


Defines or returns the color of the text for flash status "Off". LONG write-read access. 


See also 
Text list (Page 196) 
Static text (Page 165) 
Radio box (Page 207) 
Check box (Page 204) 
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Button (Page 201) 
I/O Field (Page 184) 
Screenltem Object (Page 125) 


ForeFlashColorOn Property 


Description 
Defines or returns the color of the text for flash status "On". LONG write-read access. 
See also 
Static text (Page 165) 
Text list (Page 196) 
Radio box (Page 207) 
Check box (Page 204) 
Button (Page 201) 
I/O Field (Page 184) 
Screenltem Object (Page 125) 
FrameColor Property 
Description 
Defines or returns the color of the rectangular or square area located on the graduated scale 
disk. LONG write-read access. 
See also 


WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 


FrameColorDown Property 


Description 


Defines or returns the color for the right, bottom part of the 3D frame of the button (button 
pressed). LONG write-read access. 
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See also 
WinCC Push Button Control (Page 269) 
Screenltem Object (Page 125) 
FrameColorUp Property 
Description 
Defines or returns the color for the left, top part of the 3D frame of the button (button not 
pressed). LONG write-read access. 
See also 


WinCC Push Button Control (Page 269) 
Screenltem Object (Page 125) 


FramePicture Property 


Description 


See also 


Returns the picture name of the background picture for the graduated scale disk. Read only 
access. 


WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 


FrameScale Property 


Description 


See also 


Defines or returns the diameter of the graduated scale disk in relation to smallest value of the 
width and height geometric attributes. Write/Read access. 


The value range is (scale distance - scale width) to 1. 


WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 
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FrameWidth Property 


Description 


See also 


Defines or returns the border width of the button in pixels. Write/Read access. 


WinCC Push Button Control (Page 269) 


Screenltem Object (Page 125) 


FreezeProviderConnections Property 


Description 


See also 


1.14.4.8 G 


Enables modification of the data connection properties ("ProviderType", "Source"...), without 
the change being effective immediately. On changing "SourceTagNamex", for example, 
impermissible combinations can created with "SourceTagNameyY". 


Therefore, FreezeProviderConnections" must be set to TRUE before modifying a data 
connection attribute. After modifying all the data connection, "FreezeProviderConnection" is 
set to FALSE and the changes take effect. 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


GlobalColorScheme property 


Description 


438 


Defines whether the colors defined for the current design in the global color scheme will be 
used for this object. 


TRUE if the object is displayed with the colors from the global color scheme defined for this 
object type. 


FALSE if the object is displayed with the colors as per the settings in the object. 
BOOLEAN write-read access. 
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GlobalShadow property 


Description 
Defines whether the object will be displayed with the shadowing defined in the active design. 
TRUE if the object is displayed with the global shadow defined for this object type. 
FALSE if no shadow is displayed. 
BOOLEAN write-read access. 


GraphDirection property (before WinCC V7) 


Description 
Defines which edge of the trend window should display the current values. Write/Read access. 
0: Positive values run to the right and upwards. 
-1: Positive values run to the left and upwards. 
-2: Positive values run to the right and upwards. 
-3: Positive values run to the right and downwards. 
See also 


WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


GraphDirection Property 


Write direction - GraphDirection 


Defines the direction of the update of axis values. 


Value Description Explanation 

0 From the right The updated values are displayed starting at the right in the control. 
1 From the left The updated values are displayed starting at the left in the control. 

2 From the top The updated values are displayed starting at the top in the control. 

3 From the bottom The updated values are displayed starting at the bottom in the control. 


True type fonts must be used within the trend window if "From the top" or "From the bottom" 
is selected for write direction. Only this setting ensures legibility of the labeling of the vertical 
axis. 


The attribute can be assigned dynamic properties by means of the name GraphDirection. The 
data type is LONG. 
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GridLineColor property 


Color of the row divider / content - GridLineColor 


Defines the color of row/column dividers in table contents. The button opens the "Color 
selection" dialog. 


The attribute can be assigned dynamic properties by means of the name GridLineColor. The 
data type is LONG. 


GridLineHorz Property 


Description 


TRUE, when the message window columns are separated by horizontal dividing lines. 
BOOLEAN write-read access. 


See also 
WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 

GridLines Property 

Description 
TRUE, when the trend window is displayed with grid lines parallel to the X-axis. The distance 
between two grid lines can be changed using the "GridLineValue" property. BOOLEAN write- 
read access. 

See also 


WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 


GridlinesValueX Property 


Description 


Defines or returns the distance between two grid lines on the X-axis. Whether the information 
is evaluated is dependent on the value of the "GridLinesX" property. 
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See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


GridlinesValueY Property 


Description 


Defines or returns the distance between two grid lines on the Y-axis. Whether the information 
is evaluated is dependent on the value of the "GridLinesY" property. 


See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


GridlinesX Property 


Description 


TRUE, when the trend window is displayed with grid lines parallel to the X-axis. The distance 
between two grid lines can be changed using the "GridLineValueX" property. 


See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


GridlinesY Property 


Description 


TRUE, when the trend window is displayed with grid lines parallel to the Y-axis. The distance 
between two grid lines can be changed using the "GridLineValueX" property. 


See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
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GridLineValue Property 


Description 


Defines the distance between two grid lines. Whether the information is evaluated is 
dependent on the value of the "GridLines" property. 


See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 
GridLineVert Property 
Description 
TRUE, when the message window columns are separated by vertical dividing lines. BOOLEAN 
write-read access. 
See also 


WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 


GridLineWidth property 
Width of dividers - GridLineWidth 


Defines the line weight of the row/column dividers in pixels. 


The attribute can be assigned dynamic properties by means of the name GridLineWidth. The 
data type is LONG. 


1.14.4.9 H 


Ha - Hi 


HandFillColor Property 


Description 


Defines or returns the fill color of all the hands in the analog clock. In order that the hands are 
displayed with the fill color defined, the "Handtype" property must be set to "0" (covering). 
LONG write-read access. 
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See also 
WinCC Digital/Analog Clock (Page 246) 
Screenltem Object (Page 125) 
Handtype Property 
Description 
Defines the representation of the hands: 
e@ 0: The hands are filled in the hand color defined and the edges in the foreground color. 
e@ 1: The hands fill color is transparent and the edges displayed in the foreground color. 
See also 
WinCC Digital/Analog Clock (Page 246) 
Screenltem Object (Page 125) 
HeaderSort Property 
Description 
Specifies if sorting of messages by message block column header is possible. 
See also 
WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 
Height Property 
Description 


Defines or returns the height of the object in pixels. 


LONG (write-read access) 
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Example: 


The following example halves the height of all objects in the "NewPDL1" picture whose names 
begin with "Circle": 


'VBS75 

Dim objScreen 

Dim objCircle 

Dim lngIndex 

Dim strName 

IngIndex = 1 

Set objScreen = HMITRuntime.Screens ("NewPDL1") 
For IngIndex = 1 To objScreen.ScreenItems.Count 
’ 

"Searching all circles 

strName = objScreen.ScreenItems.Item(lngIndex) .ObjectNam 
If "Circle" = Left(strName, 6) Then 


"to halve the height of the circles 


Set objCircle = objScreen.ScreenItems (strName) 
objCircle.Height = objCircle.Height / 2 
End If 
ext 
See also 


Width Property (Page 698) 
Object types of the Screenltem object (Page 143) 
Screenltem Object (Page 125) 


HiddenInput Property 


Description 


TRUE, when the input value should not be displayed when being entered. Each character 
entered is substituted by a *. BOOLEAN write-read access. 


See also 
I/O Field (Page 184) 
Screenltem Object (Page 125) 
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HideTagNames Property 


Description 


TRUE if the archive and tag name in the trend should be hidden via the right mouse button, 
in the status line and in the table to display the coordinates. BOOLEAN write-read access. 


HitlistColumnAdd property 


HitlistColumnAdd 


Transfers the selected message block from the list of available message blocks to the list of 
selected message blocks. 


The attribute can be assigned dynamic properties by means of the name HitlistColumnAdd . 
The data type is STRING. 


HitlistColumnAutoAdjust property 


See also 


HitlistColumnAutoAdjust 


Automatically optimizes the width of the columns in the hit list in Runtime. If the configured 
column is not sufficient for the displayed text, the column width is increased. 


If the user changes the width of columns in Runtime, the width is only optimized again when 
the picture is opened again. 


The attribute can be assigned dynamic properties using the name HitlistColumnAutoAdjust. 
The data type is BOOLEAN. 


WinCC AlarmControl (Page 241) 
HitlistColumn object (list) (Page 222) 


HitlistColumnCount property 


HitlistColumnCount 


Specifies the number of message blocks displayed in the hitlist in Runtime. 


The attribute can be assigned dynamic properties by means of the name 
HitlistColumnCount . The data type is LONG. 
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HitlistColumnIndex property 


HitlistColumnIndex 


References a message block selected for the hitlist. Using this attribute you can assign the 
values of other attributes to a specific message block of the hitlist. 


Values between 0 and "HitlistColumnCount" minus 1 are valid for "HitlistColumnIndex". 
Attribute "HitlistColumnCount" defines the number of message blocks selected for the hitlist. 


The "HitlistColumnIndex" attribute can be assigned dynamic properties by means of attribute 
HitlistColumnRepos. The data type is LONG. 


HitlistColumnName property 


HitlistColumnName 


Displays the name of the message block of the hitlist which is referenced with attribute 
"HitlistColumnIndex". You cannot edit this name. 


The attribute can be assigned dynamic properties by means of the name 
HitlistColumnName . The data type is STRING. 


HitlistColumnRemove property 


HitlistColumnRemove 


Cuts the marked message block from the list of selected message blocks and pastes it to the 
list of available message blocks. 


The attribute can be assigned dynamic properties by means of the name 
HitlistColumnRemove. The data type is STRING. 


HitlistColumnRepos 


Up/Down - MessageColumnRepos/HitlistColumnRepos 
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Resorts the message blocks. The "Up" and "Down" commands move the selected message 
block accordingly in the list. This moves the message block in Runtime Control towards the 
front or towards the back. 


The attribute for the hitlist can be assigned dynamic properties by means of the name 
HitlistColumnRepos . 


The attribute for the message list can be assigned dynamic properties by means of the name 
MessageColumnRepos. 


The data type is LONG. 
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HitlistColumnSort property 


HitlistColumnSort 
Defines the sorting order of the message block referenced in "HitlistColumnIndex" for the hitlist. 


The following settings are available: 


Value Description Explanation 

0 none No sorting 

1 Ascending Ascending order, starting at the lowest value. 

2 Descending Descending order, starting at the highest value. 


The attribute can be assigned dynamic properties by means of the name HitlistColumnSort . 
The data type is LONG. 


HitlistColumnSortindex property 


HitlistColumnSortIndex 


Defines the sorting order of the message block referenced in "HitlistColumnindex" in the hitlist. 
The sorting criterion is removed from "HitlistColumnSort" if you set a "0" value.. 


The attribute can be assigned dynamic properties by means of the name 
HitlistColumnSortIndex. The data type is LONG. 


HitlistColumnVisible 


Selected message blocks - MessageColumnVisible/HitlistColumnVisible 


Selected message blocks of message list or hitlist that are displayed in Runtime. Defines 
whether the message block referenced in "MessageColumnIndex" or "HitlistColumnIndex" is 
displayed. 


The attribute for the message list can be assigned dynamic properties by means of the name 
MessageColumn Visible. 


The attribute for the hitlist can be assigned dynamic properties by means of the name 
HitlistColumnVisible. 


The data type is BOOLEAN. 


HitlistDefaultSort property 


HitlistDefaultSort 


Defines the default sorting order in the table columns of the hitlist. 
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The following settings are available: 


Description Explanation 
0 Ascending The list is sorted in ascending order based on frequency. 
1 Descending The list is sorted in descending order based on frequency. 


The attribute can be assigned dynamic properties by means of the name HitlistDefaultSort. 
The data type is LONG. 


HitListMaxSourceltems property 


Maximum number of data records - HitListWaxSourceltems 


Defines the maximum number of data records for statistics. 


The attribute can be assigned dynamic properties by means of the name 
HitListWaxSourceltems . The data type is LONG. 


HitListMaxSourceltemsWarn property 


Warning when maximum is reached - HitListMaxSourceltemsWarn 


Enables the output of a warning notice after the valid number of data records was reached. 


Value Explanation 
TRUE A warning is output after the valid maximum number of data records was reached. 
FALSE A warning is not output after the valid maximum number of data records was reached. 
The attribute can be assigned dynamic properties by means of the name 
HitListWaxSourceltemsWarn. The data type is BOOLEAN. 
HitListRelTime property 


Time range for statistics - HitListRelITime 


Sets a time range for the statistics. 


Value Explanation 
TRUE The time range set for statistics is used if this range was not defined in the selection. 
FALSE The time range is not used. 
The attribute can be assigned dynamic properties by means of the name HitListRelTime. The 
data type is BOOLEAN. 
WinCC: Scripting (VBS, ANSI-C, VBA) 
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HitListRelTimeFactor property 


Time range - HitListRelTimeFactor 


Defines the factor for calculating the time range. Only integer factors are valid. 


The attribute can be assigned dynamic properties by means of the name 
HitListRelTimeFactor. The data type is LONG. 


HitListRelTimeFactorType property 


Time range - HitListRelTimeFactorType 


Defines the time unit for calculating the time range. 


The following time units are available: 


Value Description 

0 Minute 

1 Hour 

2 Day 

3 Week 

4 Month 
The attribute can be assigned dynamic properties by means of the name 
HitListWaxRelTimeFactorType. The data type is LONG. 

Ho - Hy 


HorizontalGridLines property 


Horizontal - HorizontalGridLines 


Defines whether horizontal separating lines will be displayed. 


Value Explanation 
TRUE Enables the display of horizontal dividers. 
FALSE Disables the display of horizontal dividers. 


The attribute can be assigned dynamic properties by means of the name 
HorizontalGridLines. The data type is BOOLEAN. 
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Hotkey Property 

Description 
Returns the function key related to the mouse operation in respect of a button object. 
Read only access. 

See also 
Button (Page 201) 
Screenltem Object (Page 125) 

HourNeedleHeight Property 

Description 
Defines or returns the length of the hour hand for the analog clock. The specification of the 
length is entered as a percentage value in relation to half the length of the short side of the 
rectangular background. Write/Read access. 
Example: 
The shorter side of the rectangular background is 100 pixels long. 
The hour hand length is 50. 
This results in a length of the hour hand of (100 pixels / 2) * 0.5 = 25 pixels. 

See also 
WinCC Digital/Analog Clock (Page 246) 
Screenltem Object (Page 125) 

HourNeedleWidth Property 

Description 
Defines or returns the width of the hour hand for the analog clock. The width is specified as a 
percentage value related to double the length of the hour hand. Write/Read access. 
Example: 
The length of the hour hand is 25 pixels. 
The hour hand width is 10. 
This results in a width of the hour hand of 25 pixels * 2 * 0.1 = 5 pixels. 

See also 
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WinCC Digital/Analog Clock (Page 246) 
Screenltem Object (Page 125) 
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Hysteresis Property 


Description 
TRUE, when the display should appear with hysteresis. BOOLEAN write-read access. 
See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
HysteresisRange Property 
Description 
Defines the hysteresis in % of the displayed value or returns it. 
The Hysteresis property must be set to TRUE for the hysteresis to be calculated. 
See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
1.14.4.10 I 
IconSpace property 
IconSpace 


Defines the spacing between the icons and text in the table cells. The value is active if and 
icon and text are displayed. 


The attribute can be assigned dynamic properties by means of the name IconSpace. The data 
type is LONG. 


IndependentWindow property 


Description 


Defines whether the display of the picture window in Runtime depends on the process picture 
in which the picture window was configured. 


TRUE if the size and position of the picture window are independent of the process picture 
and only defined by the "Window mode" attribute. 
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Index Property 


Description 


See also 
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FALSE if the size and position of the picture window change with the shift or scaling of the 
process picture. 


Check box, radio box 
Defines or returns the number (0 to 31) of the field whose text is to be defined. 


Combo box, list box 
Defines or returns the number (0 to 31) of the line whose text is to be defined. 


Polygon, polyline, tube polygon 

Defines or returns the number of the corner point whose position coordinates are to be modified 
or displayed. 

WinCC online trend control, WinCC online table control, WinCC function trend control 


The "Index" property is evaluated by other properties in order to be able to assign the settings 
to a specific trend or column pair. The valid values for the index move within the range from 0 
to (Numltems - 1). The "Numltems" properties contains the number of the trends/column pairs 
to be displayed. The index must always be set before you change the properties of a trend / 
column in runtime. 

Status display 


Defines the status (0 to 255) or returns it. A basic picture and flash picture can be defined for 
each status value. 


Status display (Page 199) 

WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Polyline (Page 158) 

Polygon (Page 156) 

Radio box (Page 207) 

Check box (Page 204) 

Screenltem Object (Page 125) 
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InnerBevelOffset Property 


Description 
Defines the distance between the inner and outer bevels. 


See also 
WinCC Slider Control (Page 277) 
Screenltem Object (Page 125) 


InnerBevelStyle Property 


Description 
Defines the 3D effect for the inner bevel of the object. 
@ 0: No border. 
e 1: The border is displayed depressed. 
@ 2: The border is displayed raised. 


e@ 3: The border is displayed in one color without a 3D effect. The border color is defined by 
the "BevelColorDown" property. 


See also 
WinCC Slider Control (Page 277) 
Screenltem Object (Page 125) 


InnerBevelWidth Property 


Description 
Defines the width of the inner bevel in pixels. 


See also 
WinCC Slider Control (Page 277) 
Screenltem Object (Page 125) 
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InputValue property 


Description 


Defines the value to be entered by the user in the I/O field. The value is not displayed in the I/ 
O field when the property is set. 


If you want the value to be displayed in the I/O field after confirmation with the <Return> key, 
configure a direct connection between the properties "input value" and "output value". The 
direct connection is only practical when no tag is connected to the output value, but the user 
can nevertheless query the specified value, for example, through a script. 


LONG write-read access. 


See also 
Example: Calling Methods of an ActiveX Control (Page 841) 

InsertData Property 

Description 
Inserts data for the current trend. 
TRUE : "Datalndex" is ignored and the data is appended to that in the data buffer. 
FALSE : The data is inserted at the "Datalndex" position in the data buffer. 
The trend window is redrawn following each operation involving "Insert Data". 
Note 
The property is only supported for the controls prior to WinCC V7. 

See also 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


Instance property 


Description 


See also 
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Returns an instance of the alarm object. 


Alarms object (list) (Page 110) 
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ltemBorderBackColor Property 


Description 


Defines or returns the background color for dividing lines in the selection list of the text list 
object. LONG write-read access. The background color is only visible with the property setting 
ItemBorderStyle > 0. 


See also 
Text list (Page 196) 
Screenltem Object (Page 125) 


ltemBorderColor Property 


Description 


Defines or returns the color for deviding lines in the selection list of the text list object. LONG 
write-read access. 


See also 
Text list (Page 196) 
Screenltem Object (Page 125) 


ItemBorderStyle Property 


Description 


Defines or returns the color for the dividing line style in the selection list of the text list object. 
Value range from 0 to 4. 


0 = solid line 

1 = dashed line 

2 = dotted line 

3 = dash-dotted line 
4 = dash-dot-dot line 


See also 
Text list (Page 196) 
Screenltem Object (Page 125) 
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ItemBorderWidth Property 


Description 


See also 


Defines or returns the dividing line weight in pixels in the selection list of the text list object. 


Text list (Page 196) 
Screenltem Object (Page 125) 


ItemProviderClsid Property 


Description 


"ItemProviderClsid" shows, if the trend referenced using Index in Trend Control is connected 
with an archive tag or an online tag. 


Notice: If you assign a value to the "ProviderClsid" property , you will overwrite the trend- 
specific property "ItemProviderClsid". 


e {416A09D2-8B5A-11D2-8B81-006097A45D48}: The trend is connected to an archive tag. 
e {A3F69593-8AB0-11D2-A440-O0OAOC9DBB64E}: The trend is connected to an online tag. 


If the trends are being supplied with archive and online tags, the property "ProviderClsid" 
returns the value "{O0000000-0000-0000-0000-000000000000}". 


ItemVisible Property 


Description 


See also 
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TRUE, when a trend or a column pair reference by the "Index" property is visible. BOOLEAN 
write-read access. 


WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
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1.14.4.11 L 


Lab - Las 


Label Property 


Description 
The "Index" property references a trend. Label is used to define the name of the time axis or 
value axis in accordance with the value of the "TimeAxis" property. 
See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 
LabelColor Property 
Description 
Defines the color of the scale label. 
See also 
WinCC Slider Control (Page 277) 
Screenltem Object (Page 125) 
LabelX Property 
Description 
Defines or returns the label on the X-axis for a trend referenced by "Index" according to the 
value of "TimeAxisX". Write/Read access. 
See also 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
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LabelY Property 


Description 


See also 


Defines or returns the label on the Y-axis for a trend referenced by "Index" according to the 
value of "TimeAxisY". Write/Read access. 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


LanguageSwitch Property 


Description 
Returns the value which defines where the language dependent assigned texts are stored. 
Read only access. 
TRUE, when the texts in the Text Library are managed. Translation to other language occurs 
in the Text Library. 
FALSE, when the texts are managed directly in the object. Translation to other language can 
be carried out using Text Distributor. 

See also 
Text list (Page 196) 
Screenltem Object (Page 125) 

Language Property 

Description 
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Defines the current Runtime language or reads it. 


You specify the Runtime language in VBS by using a country code, e.g., 1031 for German - 
Default, 1033 for English - USA etc. Asummary of all country codes may be found in the Basics 
of VBScript under the subject header "Regional Scheme ID (LCID) Diagram". 


INTEGER (write-read access) 
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"VBS76 


7.14 VBS Reference 


The following example sets the data language to German: 


HMTIRuntime.Language = 1031 


See also 
HM IRuntime Object (Page 118) 
LastError Property 
Description 
Returns an error code regarding the success of the last operation, e.g. information on a tag 
write or read process. The "QualityCode" property can provide information on the quality of 
the returned value. A description of the error can be called in using the "ErrorDescription" 
property. 
LONG (read only) 
The following error codes are defined: 
Code in hexadecimal notation Description 
0x00000000 OK 
0x80040001 Execution error 
0x80040002 Tag error 
0x80040003 Server not available. 
0x80040004 Multi Tag Error (Error in one or several tags) 
In order that LastError returns a value, a read must be executed beforehand. 
If an error occurs during read or write of several tags using the TagSet object, the error is set 
to "Multi Tag Error". In order to determine at which tag the error occurred and what type of 
error it was, the LastError property of each tag must be analyzed. 
Example: 
The following example displays the error code for "Tag1": 
'VBS77 


Dim objTag 


Set objTag = HMIRuntime.Tags ("Tagl") 


objTag.Read 


MsgBox objTag.LastError 
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The following example adds two tags to the TagSet list and outputs the LastError property as 
Trace. 


'VBS178 

Dim group 

Set group = HMIRuntime.Tags.CreateTagSet 

group.Add "Motor1" 

group.Add "Motor2" 

HMIRuntime.Trace "LastError: " & group.LastError & vbNewLine 


The LastError property of a tag contained in the list may be accessed as follows: 


HMIRuntime.Trace "LastError: " & group("Motorl1").LastError & vbNewLine 


See also 
TagSet Object (List) (Page 141) 
QualityCode Property (Page 546) 
ErrorDescription Property (Page 411) 
Tag Object (Page 137) 


Layer 


Layer Property 


Description 


Returns the layer of the picture in which the object is located. There is a total of 32 layers 
available, whereby Layer "0" is the bottom layer and Layer "31" the top layer. 


The configured objects are initially in the background of a layer. 
LONG (read only) 


Note 


The layer property specifies the layer in which the object is located. The layer "0" is output as 
"LayerO". 


When accessed, the layers are counted up from 1 in VBS. Therefore, the layer "1" must be 
addressed with "layers(2)". 
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Example: 


The following example displays the name and layer of all the objects in the picture "NewPDL1": 


'VBS78 

Dim objScreen 

Dim objScriItem 

Dim lngAnswer 

Dim IngIndex 

Dim strName 

IngIndex = 1 

Set objScreen = HMITRuntime.Screens ("NewPDL1") 
For lngIndex = 1 To objScreen.ScreenItems.Count 
strName = objScreen.ScreenItems.Item(lngIndex) .ObjectNam 
Set objScrItem = objScreen.ScreenItems (strName) 


IngAnswer = MsgBox(strName & " is in layer " & objScrItem.Layer,vbOKCancel) 
If vbCancel = lngAnswer Then Exit For 

Next 

See also 


Screenltem Object (Page 125) 


Layer0OChecked Property 


Description 


TRUE, when limit 0 should be monitored. BOOLEAN write/read access. 
Limit value and representation are defined with the LayerOOValue and Layer00Color 
properties. 


See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 


Layer01Checked Property 


Description 


TRUE, when limit 1 should be monitored. BOOLEAN write/read access. 
Limit value and representation are defined with the Layer01Value and Layer01Color 
properties. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 461 


VBS for Creating Procedures and Actions 


7.14 VBS Reference 


See also 


3D Bar (Page 169) 
Screenltem Object (Page 125) 


Layer02Checked Property 


Description 


See also 


TRUE, when limit 2 should be monitored. BOOLEAN write/read access. 
Limit value and representation are defined with the LayerO2Value and Layer02Color 
properties. 


3D Bar (Page 169) 
Screenltem Object (Page 125) 


Layer03Checked Property 


Description 


See also 


TRUE, when limit 3 should be monitored. BOOLEAN write/read access. 
Limit value and representation are defined with the LayerO3Value and Layer03Color 
properties. 


3D Bar (Page 169) 
Screenltem Object (Page 125) 


Layer04Checked Property 


Description 


See also 
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TRUE, when limit 4 should be monitored. BOOLEAN write/read access. 
Limit value and representation are defined with the LayerO4Value and Layer04Color 
properties. 


3D Bar (Page 169) 
Screenltem Object (Page 125) 
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Layer05Checked Property 


Description 
TRUE, when limit 5 should be monitored. BOOLEAN write/read access. 
Limit value and representation are defined with the LayerO5Value and Layer05Color 
properties. 
See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 
LayerO6Checked Property 
Description 
TRUE, when limit 6 should be monitored. BOOLEAN write/read access. 
Limit value and representation are defined with the LayerO6Value and Layer06Color 
properties. 
See also 


3D Bar (Page 169) 
Screenltem Object (Page 125) 


Layer07Checked Property 


Description 
TRUE, when limit 7 should be monitored. BOOLEAN write/read access. 
Limit value and representation are defined with the LayerO7Value and Layer07Color 
properties. 

See also 


3D Bar (Page 169) 
Screenltem Object (Page 125) 
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LayerO08Checked Property 


Description 


See also 


TRUE, when limit 8 should be monitored. BOOLEAN write/read access. 
Limit value and representation are defined with the LayerO8Value and Layer08Color 
properties. 


3D Bar (Page 169) 
Screenltem Object (Page 125) 


Layer09Checked Property 


Description 


See also 


TRUE, when limit 9 should be monitored. BOOLEAN write/read access. 
Limit value and representation are defined with the LayerO9Value and Layer09Color 
properties. 


3D Bar (Page 169) 
Screenltem Object (Page 125) 


Layer10Checked Property 


Description 


See also 
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TRUE, when limit 10 should be monitored. BOOLEAN write/read access. 
Limit value and representation are defined with the Layer10Value and Layer10Color 
properties. 


3D Bar (Page 169) 
Screenltem Object (Page 125) 
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Layer00Color Property 


Description 


Defines or returns the color for limit 0. LONG write/read access. 
When monitoring of the limit value is activated (LayerOOChecked property), the bar turns to 
the color defined by this attribute on reaching the limit value. 


See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 
Layer01Color Property 
Description 
Defines or returns the color for limit 1. LONG write/read access. 
When monitoring of the limit value is activated (Layer01 Checked property), the bar turns to 
the color defined by this attribute on reaching the limit value. 
See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 
Layer02Color Property 
Description 
Defines or returns the color for limit 2. LONG write/read access. 
When monitoring of the limit value is activated (LayerO2Checked property), the bar turns to 
the color defined by this attribute on reaching the limit value. 
See also 


3D Bar (Page 169) 
Screenltem Object (Page 125) 
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Layer03Color Property 


Description 


Defines or returns the color for limit 3. LONG write/read access. 
When monitoring of the limit value is activated (LayerO3Checked property), the bar turns to 
the color defined by this attribute on reaching the limit value. 


See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 
Layer04Color Property 
Description 
Defines or returns the color for limit 4. LONG write/read access. 
When monitoring of the limit value is activated (LayerO04Checked property), the bar turns to 
the color defined by this attribute on reaching the limit value. 
See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 
Layer05Color Property 
Description 
Defines or returns the color for limit 5. LONG write/read access. 
When monitoring of the limit value is activated (LayerO5Checked property), the bar turns to 
the color defined by this attribute on reaching the limit value. 
See also 


466 


3D Bar (Page 169) 
Screenltem Object (Page 125) 
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LayerO6Color Property 


Description 


Defines or returns the color for limit 6. LONG write/read access. 
When monitoring of the limit value is activated (LayerO6Checked property), the bar turns to 
the color defined by this attribute on reaching the limit value. 


See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 
Layer07Color Property 
Description 
Defines or returns the color for limit 7. LONG write/read access. 
When monitoring of the limit value is activated (LayerO7 Checked property), the bar turns to 
the color defined by this attribute on reaching the limit value. 
See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 
Layer08Color Property 
Description 
Defines or returns the color for limit 8. LONG write/read access. 
When monitoring of the limit value is activated (LayerO8Checked property), the bar turns to 
the color defined by this attribute on reaching the limit value. 
See also 


3D Bar (Page 169) 
Screenltem Object (Page 125) 
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Layer09Color Property 


Description 


Defines or returns the color for limit 9. LONG write/read access. 
When monitoring of the limit value is activated (LayerO9Checked property), the bar turns to 
the color defined by this attribute on reaching the limit value. 


See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 
Layer10Color Property 
Description 
Defines or returns the color for limit 10. LONG write/read access. 
When monitoring of the limit value is activated (Layer10Checked property), the bar turns to 
the color defined by this attribute on reaching the limit value. 
See also 


3D Bar (Page 169) 
Screenltem Object (Page 125) 


LayerOOFillColor property 
Bar fill color 0 (LayerOOFillColor) 
The "LayerOOFillColor" attribute defines the color with which the bar is filled in relation to "Limit 
0". 


The "LayerOOFillColor" attribute can be made dynamic with the name "LayerOOFillColor". 


Layer01FillColor property 
Layer01FillColor 


The "Layer01FillColor" attribute defines the color with which the bar is filled in relation to "Limit 
Ik: 


The "Layer01FillColor" attribute can be made dynamic with the name "Layer01FillColor". 


Layer02FillColor property 
Layer02FillColor 
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The "Layer02FillColor" attribute defines the color with which the bar is filled in relation to "Limit 
20 


The "Layer02FillColor" attribute can be made dynamic with the name "Layer02FillColor". 


Layer03FillColor property 
Layer03FillColor 


The "Layer03FillColor" attribute defines the color with which the bar is filled in relation to "Limit 
3". 


The "Layer03FillColor" attribute can be made dynamic with the name "Layer03FillColor". 


Layer04FillColor property 
Layer04FillColor 


The "Layer04FillColor" attribute defines the color with which the bar is filled in relation to "Limit 
4", 


The "Layer04FillColor" attribute can be made dynamic with the name "Layer04FillColor". 


Layer05FillColor property 
Layer05FillColor 


The "Layer05FillColor" attribute defines the color with which the bar is filled in relation to "Limit 
5". 


The "Layer05FillColor" attribute can be made dynamic with the name "Layer05FillColor". 


Layer06FillColor property 
Layer06FillColor 


The "LayerO6FillColor" attribute defines the color with which the bar is filled in relation to "Limit 
6". 


The "Layer06FillColor" attribute can be made dynamic with the name "Layer06FillColor". 


Layer07FillColor property 
Layer07FillColor 


The "Layer07FillColor" attribute defines the color with which the bar is filled in relation to "Limit 
7". 


The "Layer07FillColor" attribute can be made dynamic with the name "Layer07FillColor". 


Layer08FillColor property 
Layer08FillColor 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 469 


VBS for Creating Procedures and Actions 
7.14 VBS Reference 


The "Layer08FillColor" attribute defines the color with which the bar is filled in relation to "Limit 
8". 


The "Layer08FillColor" attribute can be made dynamic with the name "Layer08FillColor". 


Layer09FillColor property 
Layer09FillColor 
The "Layer09FillColor" attribute defines the color with which the bar is filled in relation to "Limit 
9". 


The "LayerO9FillColor" attribute can be made dynamic with the name "Layer09FillColor". 


Layer10FillColor property 
Layer10FillColor 


The "Layer10FillColor" attribute defines the color with which the bar is filled in relation to "Limit 
10". 


The "Layer10FillColor" attribute can be made dynamic with the name "Layer10FillColor". 


LayerOOFillStyle property 
Layer0OFillStyle 


The "LayerOOFillStyle" attribute defines the style of the bar in relation to "Limit 0". For the fill 
pattern to become visible, "bar fill color 0" must differ from "bar color 0". 


There is a choice of 50 fill styles. The 0 "Solid" fill style fills the object with the set background 
color. The 1 "Transparent" fill style means neither a background nor a fill pattern is displayed. 


The "LayerOOFillStyle" attribute can be made dynamic with the name "LayerOOFillStyle". 


Layer01FillStyle property 
Layer01FillStyle 


The "Layer01FillStyle" attribute defines the style of the bar in relation to "Limit 1". For the fill 
pattern to become visible, "bar fill color 1" must differ from "bar color 1". 


There is a choice of 50 fill styles. The 0 "Solid" fill style fills the object with the set background 
color. The 1 "Transparent" fill style means neither a background nor a fill pattern is displayed. 


The "Layer01FillStyle" attribute can be made dynamic with the name "Layer01FillStyle". 


Layer02FillStyle property 
Layer02FillStyle 


The "Layer02FillStyle" attribute defines the style of the bar in relation to "Limit 2". For the fill 
pattern to become visible, "bar fill color 2" must differ from "bar color 2". 


There is a choice of 50 fill styles. The 0 "Solid" fill style fills the object with the set background 
color. The 1 "Transparent" fill style means neither a background nor a fill pattern is displayed. 
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The "Layer02FillStyle" attribute can be made dynamic with the name "Layer02FillStyle". 


Layer03FillStyle property 
Layer03FillStyle 


The "Layer03FillStyle" attribute defines the style of the bar in relation to "Limit 3". For the fill 
pattern to become visible, "bar fill color 3" must differ from "bar color 3". 


There is a choice of 50 fill styles. The 0 "Solid" fill style fills the object with the set background 
color. The 1 "Transparent" fill style means neither a background nor a fill pattern is displayed. 


The "Layer03FillStyle" attribute can be made dynamic with the name "Layer03FillStyle". 


Layer04FillStyle property 
Layer04FillStyle 


The "Layer04FillStyle" attribute defines the style of the bar in relation to "Limit 4". For the fill 
pattern to become visible, "bar fill color 4" must differ from "bar color 4". 


There is a choice of 50 fill styles. The 0 "Solid" fill style fills the object with the set background 
color. The 1 "Transparent" fill style means neither a background nor a fill pattern is displayed. 


The "Layer04FillStyle" attribute can be made dynamic with the name "Layer04FillStyle". 


Layer05FillStyle property 
Layer05FillStyle 


The "Layer05FillStyle" attribute defines the style of the bar in relation to "Limit 5". For the fill 
pattern to become visible, "bar fill color 5" must differ from "bar color 5". 


There is a choice of 50 fill styles. The 0 "Solid" fill style fills the object with the set background 
color. The 1 "Transparent" fill style means neither a background nor a fill pattern is displayed. 


The "LayerO5FillStyle" attribute can be made dynamic with the name "LayerO5FillStyle". 


Layer06FillStyle property 
Layer06FillStyle 


The "Layer06FillStyle" attribute defines the style of the bar in relation to "Limit 6". For the fill 
pattern to become visible, "bar fill color 6" must differ from "bar color 6". 


There is a choice of 50 fill styles. The 0 "Solid" fill style fills the object with the set background 
color. The 1 "Transparent" fill style means neither a background nor a fill pattern is displayed. 


The "Layer06FillStyle" attribute can be made dynamic with the name "Layer06FillStyle". 


Layer07FillStyle property 
Layer07FillStyle 


The "Layer07FillStyle" attribute defines the style of the bar in relation to "Limit 7". For the fill 
pattern to become visible, "bar fill color 7" must differ from "bar color 7". 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 471 


VBS for Creating Procedures and Actions 


7.14 VBS Reference 


There is a choice of 50 fill styles. The 0 "Solid" fill style fills the object with the set background 
color. The 1 "Transparent" fill style means neither a background nor a fill pattern is displayed. 


The "Layer07FillStyle" attribute can be made dynamic with the name "Layer07FillStyle". 


Layer08FillStyle property 


Layer08FillStyle 


The "Layer08FillStyle" attribute defines the style of the bar in relation to "Limit 8". For the fill 
pattern to become visible, "bar fill color 8" must differ from "bar color 8". 


There is a choice of 50 fill styles. The 0 "Solid" fill style fills the object with the set background 
color. The 1 "Transparent" fill style means neither a background nor a fill pattern is displayed. 


The "Layer08FillStyle" attribute can be made dynamic with the name "Layer08FillStyle". 


Layer09FillStyle property 


Layer09FillStyle 


The "Layer09FillStyle" attribute defines the style of the bar in relation to "Limit 9". For the fill 
pattern to become visible, "bar fill color 9" must differ from "bar color 9". 


There is a choice of 50 fill styles. The 0 "Solid" fill style fills the object with the set background 
color. The 1 "Transparent" fill style means neither a background nor a fill pattern is displayed. 


The "LayerO9FillStyle" attribute can be made dynamic with the name "Layer09FillStyle". 


Layer10FillStyle property 


Layer10FillStyle 


The "Layer10FillStyle" attribute defines the style of the bar in relation to "Limit 10". For the fill 
pattern to become visible, "bar fill color 10" must differ from "bar color 10". 


There is a choice of 50 fill styles. The 0 "Solid" fill style fills the object with the set background 
color. The 1 "Transparent" fill style means neither a background nor a fill pattern is displayed. 


The "Layer10FillStyle" attribute can be made dynamic with the name "Layer10FillStyle". 


Layer00Value Property 


Description 


See also 


472 


Determines the value for "Limit 0" or returns it. 
Monitoring only takes effect when the LayerOOChecked property value is set to TRUE. 


3D Bar (Page 169) 
Screenltem Object (Page 125) 
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Layer01Value Property 


Description 


Determines the value for "Limit 1" or returns it. 
Monitoring only takes effect when the Layer01Checked property value is set to TRUE. 


See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 
Layer02Value Property 
Description 
Determines the value for "Limit 2" or returns it. 
Monitoring only takes effect when the LayerO2Checked property value is set to TRUE. 
See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 
Layer03Value Property 
Description 
Determines the value for "Limit 3" or returns it. 
Monitoring only takes effect when the LayerO3Checked property value is set to TRUE. 
See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 
Layer04Value Property 
Description 


Determines the value for "Limit 4" or returns it. 
Monitoring only takes effect when the LayerO4Checked property value is set to TRUE. 
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See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 


Layer05Value Property 


Description 

Determines the value for "Limit 5" or returns it. 

Monitoring only takes effect when the LayerO5Checked property value is set to TRUE. 
See also 

3D Bar (Page 169) 

Screenltem Object (Page 125) 
Layer06Value Property 
Description 

Determines the value for "Limit 6" or returns it. 

Monitoring only takes effect when the LayerO6Checked property value is set to TRUE. 
See also 

3D Bar (Page 169) 

Screenltem Object (Page 125) 
Layer07Value Property 
Description 

Determines the value for "Limit 7" or returns it. 

Monitoring only takes effect when the LayerO7Checked property value is set to TRUE. 
See also 


Screenltem Object (Page 125) 
3D Bar (Page 169) 
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Layer08Value Property 


Description 


Determines the value for "Limit 8" or returns it. 
Monitoring only takes effect when the LayerO8Checked property value is set to TRUE. 


See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 
Layer09Value Property 
Description 
Determines the value for "Limit 9" or returns it. 
Monitoring only takes effect when the LayerO9Checked property value is set to TRUE. 
See also 
3D Bar (Page 169) 
Screenltem Object (Page 125) 
Layer10Value Property 
Description 
Determines the value for "Limit 10" or returns it. 
Monitoring only takes effect when the Layer10Checked property value is set to TRUE. 
See also 


3D Bar (Page 169) 
Screenltem Object (Page 125) 


LayerDeclutteringEnable Property 


Description 
Returns the LayerDecluttering properties of a picture. 


LayerDecluttering enables fading in and out of layers depending on the set minimum and 
maximum zoom. 
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BOOLEAN Read-only access. 


Example: 


The example outputs the LayerDecluttering Property NewPDL1 as a trace. 


"VBS156 
Dim objScreen 
Set objScreen = HMTRuntime.Screens ("NewPDL1") 


HMIRuntime.Trace "Enable: " & objScreen.LayerDecluttering 


See also 
Screen Object (Page 131) 


Layers Property 

Description 
Returns an object of type "Layers". 
Layers (read-only) 

See also 
Layers Object (Listing) (Page 121) 
HM IRuntime Object (Page 118) 

Le - Li 

Left Property 

Description 


Enable & vbNewLine 


Defines or returns the X-coordinate of an object (measured from the top left edge of the picture) 
in pixels. The X-coordinate relates to the top left corner of the rectangle enclosing the object. 


LONG (write-read access) 
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Example: 
The following example shifts all objects in the picture "NewPDL1" 5 pixels to the left: 


"VBS79 

Dim objScreen 

Dim objScriItem 

Dim lngIndex 

Dim strName 

IngIndex = 1 

Set objScreen = HMITRuntime.Screens ("NewPDL1") 
For IngIndex = 1 To objScreen.ScreenItems.Count 
strName = objScreen.ScreenItems.Item(lngIndex) .ObjectNam 
Set objScrItem = objScreen.ScreenItems (strName) 
objScriItem.Left = objScriItem.Left - 5 

Next 


See also 
Top Property (Page 643) 
Screenltem Object (Page 125) 


LeftComma Property 


Description 

Defines or returns the number of digits to the left of the decimal point (0 to 20). 
See also 

Bar (Page 174) 

Screenltem Object (Page 125) 
LightEffect Property 
Description 

TRUE, when the light effect should be activated. BOOLEAN write-read access. 
See also 


3D Bar (Page 169) 
Screenltem Object (Page 125) 
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LimitHigh4 Property 


Description 


Determines the upper limit value for "Reserve 4" or returns it. 

The CheckLimitHigh4 property must be set to TRUE in order that the "Reserve 4" limit value 
can be monitored. 

The type of the evaluation (in percent or absolute) is defined in the TypeLimitHigh4 property. 


See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
LimitHigh5 Property 
Description 
Determines the upper limit value for "Reserve 5" or returns it. 
The CheckLimitHigh5 property must be set to TRUE in order that the "Reserve 5" limit value 
can be monitored. 
The type of the evaluation (in percent or absolute) is defined in the TypeLimitHigh5 property. 
See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
LimitLow4 Property 
Description 
Determines the lower limit value for "Reserve 4" or returns it. 
The CheckLimitLow4 property must be set to TRUE in order that the "Reserve 4" limit value 
can be monitored. 
The type of the evaluation (in percent or absolute) is defined in the TypeLimitLow4 property. 
See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
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LimitLow5 Property 


Description 


Determines the lower limit value for "Reserve 5" or returns it. 

The CheckLimitLow5 property must be set to TRUE in order that the "Reserve 5" limit value 
can be monitored. 

The type of the evaluation (in percent or absolute) is defined in the TypeLimitLow5 property. 


See also 
Bar (Page 174) 
Screenltem Object (Page 125) 

LimitMax Property 

Description 
Determines the upper limit value as an absolute value depending on the data format or returns 
it. 
If the displayed value exceeds the upper limit value, it is displayed by a sequence of *** (not 
displayable). 

See also 


I/O Field (Page 184) 
Screenltem Object (Page 125) 


LimitMin Property 


Description 


See also 


Determines the lower limit value as an absolute value depending on the data format or returns it. 
If the displayed value exceeds the upper limit value, it is displayed by a sequence of *** (not 
displayable). 


I/O Field (Page 184) 
Screenltem Object (Page 125) 
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LineColor property 


Color of window dividers - LineColor 
Specifies the color of the window dividers. The button opens the "Color selection" dialog. 


The attribute can be assigned dynamic properties by means of the name LineColor. The data 


type is LONG. 
LineFont Property 
Description 
TRUE, when the font size should be automatically adapted to the line height. BOOLEAN write- 
read access. 
See also 
WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 
LineHeight Property 
Description 
TRUE, when the line height can be modified. BOOLEAN write-read access. 
The "LineHeight" property is only deactivated if both properties "LineHeight" and "LineFont" 
are set to "FALSE". 
See also 
WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 
LineJoinStyle property 
Description 


Defines the way that corners are displayed in a tube polygon. 


Angle _ The tubes are joined at corner points without rounding 
Round The tubes are rounded at the outside corner points. 
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LineTitle Property 


Description 


TRUE, when the message window a column with consecutive number contains queued 
messages. BOOLEAN write-read access. 


See also 
WinCC Alarm Control (before WinCC V7) (Page 286) 


Screenltem Object (Page 125) 


LineWidth property (before WinCC V7) 


Description 

Specifies the line width of the trend referenced by "Index". Value range from 0 to 10. 
See also 

WinCC Online Trend Control (before WinCC V7) (Page 295) 

Screenltem Object (Page 125) 
LineWidth property 


Line weight of window dividers - LineWidth 
Defines the line weight of the window dividers in pixels. 


The attribute can be assigned dynamic properties by means of the name LineWidth. The data 
type is LONG. 


ListType Property 
Description 


Returns the data type displayed in the case of a text list object. Read only access. 


Value range from 0 to 2. 


0 = decimal 
1 = binary 
2 = bit 
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See also 
Text list (Page 196) 
Screenltem Object (Page 125) 


Lo 


LoadDatalmmediately property 


Load archive data - LoadDatalmmediately 


Defines whether the tag values for the time range to be displayed are loaded from the archives 
when the picture is called. 


Value Explanation 
TRUE Loads archived values on picture calls. 
FALSE Loads only current values on picture calls. 


The attribute can be assigned dynamic properties by means of the name 
LoadDatalmmediately. The data type is BOOLEAN. 


LoadDatalmmediately property (before WinCC V7) 


Description 


TRUE, when the tag values for the time range to be displayed are loaded from the archives 
on opening a picture. BOOLEAN write-read access. 


See also 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


LocalelD Property 
Description 


Defines the language to be displayed in the control, e.g. 1031 for German. Write/Read access. 


The list of language codes is available in the WinCC documentation (Index > Language Code). 
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See also 
WinCC Slider Control (Page 277) 
WinCC Gauge Control (Page 254) 
WinCC Digital/Analog Clock (Page 246) 
Screenltem Object (Page 125) 


LocaleSpecificSettings Property 


Description 
TRUE if a font can be assigned and formatted for each Runtime language. BOOLEAN write- 
read access. 
LockBackColor Property 
Description 
Defines or returns the background color of the button for a locked measuring point. LONG 
write/read access. 
The LockStatus property must be set to TRUE for the background color to be displayed. 
See also 
Group Display (Page 194) 
Screenltem Object (Page 125) 
LockStatus Property 
Description 
TRUE, when a locked measuring point should be displayed. BOOLEAN write-read access. 
See also 


Group Display (Page 194) 
Screenltem Object (Page 125) 
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LockText Property 


Description 


Defines the label of a button for a locked measuring point. 
The LockStatus property must be set to TRUE for the label to be displayed. 


See also 
Group Display (Page 194) 
Screenltem Object (Page 125) 
LockTextColor Property 
Description 
Defines or returns the color of the button label for a locked measuring point. LONG write/read 
access. 
The LockStatus property must be set to TRUE for the background color to be displayed. 
See also 


Group Display (Page 194) 
Screenltem Object (Page 125) 


Logging Property 


Description 


Returns an object of type "Logging". 
Logging (read-only) 


See also 
HM Runtime Object (Page 118) 
Logging Object (Page 122) 


LongStrokesBold Property 


Description 


TRUE, when the long sections of a scale should be displayed in bold face. BOOLEAN write- 
read access. 
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See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
LongStrokesOnly Property 
Description 
TRUE, when only the long sections of a scale should be displayed . BOOLEAN write-read 
access. 
See also 


Bar (Page 174) 
Screenltem Object (Page 125) 


LongStrokesSize Property 


Description 


Defines or returns the length of the axis section in pixels. 


See also 
Bar (Page 174) 
Screenltem Object (Page 125) 


LongStrokesTextEach Property 


Description 


Returns the value which defines which sections of the scale displayed should be labeled (1 = 
every section, 2 = every second section, etc.). Read only access 


See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
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LongTimeArchiveConsistency Property 


LongTimeArchiveConsistency 


If "LongTimeArchiveConsistency" is set to "No", 1000 messages are displayed in the long-term 
archive list on the single-user system, server or client for each server, or for each redundant 
server pair. 


If the "LongTimeArchiveConsistency" is set to "yes", the most recent 1000 messages are 
displayed on the client of all servers or redundant server pair in the long-term archive list. 


The attribute can be assigned dynamic properties by means of the name 
LongTimeArchiveConsistency . The data type is BOOLEAN. 


LongTimeArchiveConsistency property (before WinCC V7) 


Description 
If "LongTimeArchiveConsistency" is set to "No", 1000 messages are displayed in the long-term 
archive list in the single-user system, server or client for each server or for each redundant 
server pair. 
If the "LongTimeArchiveConsistency" is set to "yes", the most recent 1000 messages are 
displayed on the client of all servers or redundant server pair in the long-term archive list. 
Write/Read access. 
LowerLimit Property 
Description 
WinCC Online Trend Control/WinCC Function Trend Control 
TRUE, when the "LowerLimitColor" specification is to be used in order to identify the tag values 
(from a trend referenced via "Index") which lie below the value defined in "LowerLimitValue". 
BOOLEAN write-read access. 
WinCC Online Trend Control 
The value of this attribute cannot be changed. Read only access. 
See also 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
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LowerLimitColor Property 


Description 


See also 


WinCC Online Trend Control/WinCC Function Trend Control 


Defines the color to be used in order to identify the tag values (from trend referenced via 
"Index") which lie below the value defined in "LowerLimitValue". Whether the information is 
evaluated is dependent on the value of the "LowerLimit" property. The color is defined as an 
RGB value. LONG write-read access. 

Online Table Control 


The value of this attribute cannot be changed. Read only access. 


WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


LowerLimitTagName Property 


Description 


This defines the lower limit of the trend range, which is automatically taken from the variable 
properties configured in PCS 7. Write/Read access. 


LowerLimitValue Property 


Description 


See also 


WinCC Online Trend Control/WinCC Function Trend Control 

Tag values (from a trend referenced via "Index") which lie below the value defined by 
“LowerLimitValue" are identified by the color specified in "LowerLimitColor". Whether the 
information is evaluated is dependent on the value of the "LowerLimit" attribute. 

Online Table Control 

The value of this attribute cannot be changed. Read only access. 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
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WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 


1.14.4.12 M 

Ma - Mc 

Marker Property 

Description 
TRUE, when the limit values should be displayed as scale values. BOOLEAN write-read 
access. 

See also 
Bar (Page 174) 
Screenltem Object (Page 125) 

Max Property 

Description 
Defines or returns the absolute value in the case of a full value display. This value is displayed 
if the scale display is active. 

See also 


Bar (Page 174) 

Slider (Page 212) 

3D Bar (Page 169) 
Screenltem Object (Page 125) 


MaximizeButton Property 


Description 
TRUE, when the object can be maximized in Runtime. Read only access. 
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Picture Window (Page 179) 
Application Window (Page 173) 
Screenltem Object (Page 125) 


MCGUBackColorOff-Eigenschaft 


Description 


See also 


Defines or returns the background color for flash status "Off" in the case of the "Departed 
Unacknowledged" status. LONG write-read access. 


Group Display (Page 194) 
Screenltem Object (Page 125) 


MCGUBackColorOn Property 


Description 


See also 


Defines or returns the background color for flash status "On" in the case of the "Departed 
Unacknowledged" status. LONG write-read access. 


Group Display (Page 194) 
Screenltem Object (Page 125) 


MCGUBackFlash Property 


Description 


See also 


TRUE, when the background should flash when a message departs unacknowledged. 
BOOLEAN write-read access. 


Group Display (Page 194) 
Screenltem Object (Page 125) 
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MCGUTextColorOff Property 


Description 


Defines or returns the color of the text for flash status "Off" in the case of the "Departed 
Unacknowledged" status. LONG write-read access. 


See also 
Group Display (Page 194) 
Screenltem Object (Page 125) 


MCGUTextColorOn Property 


Description 


Defines or returns the background color of the text for flash status "Off" in the case of the 
"Departed Unacknowledged" status. LONG write-read access. 


See also 
Group Display (Page 194) 


Screenltem Object (Page 125) 


MCGUTextFlash Property 


Description 
TRUE, when the font should flash when a message departs unacknowledged. BOOLEAN write- 
read access. 
See also 
Group Display (Page 194) 
Screenltem Object (Page 125) 
MCKOBackColorOff Property 
Description 


Defines or returns the background color for flash status "Off" in the case of the "Arrived" status. 
LONG write-read access. 
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Group Display (Page 194) 
Screenltem Object (Page 125) 


MCKOBackColorOn Property 


Description 


See also 


Defines or returns the background color for flash status "On" in the case of the "Arrived" status. 
LONG write-read access. 


Group Display (Page 194) 
Screenltem Object (Page 125) 


MCKOBackFlash Property 


Description 
TRUE, when the background should flash when a message arrives. BOOLEAN write-read 
access. 

See also 
Group Display (Page 194) 
Screenltem Object (Page 125) 

MCKOTextColorOff Property 

Description 
Defines or returns the color of the text for flash status "Off" in the case of the "Arrived" status. 
LONG write-read access. 

See also 


Group Display (Page 194) 
Screenltem Object (Page 125) 
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MCKOTextColorOn Property 


Description 
Defines or returns the background color of the text for flash status "On" in the case of the 
"Arrived" status. LONG write-read access. 
See also 
Group Display (Page 194) 
Screenltem Object (Page 125) 
MCKOTextFlash Property 
Description 
TRUE, when the font should flash when a message arrives. BOOLEAN write-read access. 
See also 
Group Display (Page 194) 
Screenltem Object (Page 125) 
MCKQBackColorOff Property 
Description 
Defines or returns the background color for flash status "Off" in the case of the "Departed 
Acknowledgea" status. LONG write-read access. 
See also 


Group Display (Page 194) 
Screenltem Object (Page 125) 


MCKQBackColorOn Property 


Description 


Defines or returns the background color for flash status "On" in the case of the "Departed 
Acknowledged" status. LONG write-read access. 
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Group Display (Page 194) 
Screenltem Object (Page 125) 


MCKQBackFlash Property 


Description 
TRUE, when the background should flash when a message departs acknowledged. BOOLEAN 
write-read access. 

See also 
Group Display (Page 194) 
Screenltem Object (Page 125) 

MCKQTextColorOff Property 

Description 
Defines or returns the color of the text for flash status "Off" in the case of the "Departed 
Acknowledgea" status. LONG write-read access. 

See also 


Group Display (Page 194) 
Screenltem Object (Page 125) 


MCKQTextColorOn Property 


Description 


See also 


Defines or returns the background color of the text for flash status "On" in the case of the 
"Departed Acknowledged" status. LONG write-read access. 


Group Display (Page 194) 
Screenltem Object (Page 125) 
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MCKQTextFlash Property 


Description 


TRUE, when the font should flash when a message departs acknowledged. BOOLEAN write- 
read access. 


See also 
Group Display (Page 194) 
Screenltem Object (Page 125) 
MCText Property 
Description 
Defines or returns the label for the respective message class. 
See also 
Group Display (Page 194) 
Screenltem Object (Page 125) 
Me 


MeasurePoints Property 


Description 
The "Index" property references a trend. "MeasurePoints" defines the number of measuring 
points to be displayed. The information is only evaluated when the "TimeAxis" property is set 
to the value "-1". 

See also 


WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 
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MenuToolBarConfig Property 


Description 


Loads the given configuration file with configured menu and toolbars or returns the name of 
the configuration file. STRING (write-read access) 


See also 
Picture Window (Page 179) 
HM Runtime Object (Page 118) 


MessageBlockAlign property 


Alignment - MessageBlockAlign 
Aligns the contents of a selected message block in the table. 


To change the alignment, the option "Apply project settings" must be deactivated or 
"ApplyProjectSettings" must be set to "FALSE". 


The following settings are available: 


Value | Description Explanation 

0 Left Aligns the contents of a selected message block to the left. 

1 Centered Aligns the contents of a selected message block to the center. 
2 Right Aligns the contents of a selected message block to the right. 


The attribute can be assigned dynamic properties by means of the name MessageBlockAlign. 
The data type is LONG. 


MessageBlockAutoPrecisions property 


Automatic decimal places - MessageBlockAutoPrecisions 


Enables automatic setting of the number of decimal places. 


Value Explanation 
TRUE The number of decimal places is set automatically. The value in the "Decimal places" field is disabled. 
FALSE The value in the "Decimal places" field is enabled. 


The attribute can be assigned dynamic properties by means of the name 
MessageBlockAutoPrecisions. The data type is BOOLEAN. 
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MessageBlockCaption property 


Label - MessageBlockCaption 


Defines the label of the column title in the message window for the selected message block. 
The label specified is active in all Runtime languages. 


To change the label, the option "Apply project settings" must be deactivated or 
"ApplyProjectSettings" must be set to "FALSE". 


The attribute can be assigned dynamic properties by means of the name 
MessageBlockCaption. The data type is STRING. 


MessageBlockCount property 


MessageBlockCount 


Defines the number of message blocks which are available for the message list and the hitlist. 


The attribute can be assigned dynamic properties by means of the name 
MessageBlockCount . The data type is LONG. 


MessageBlockDateFormat property 


Date format - MessageBlockDateFormat 
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Defines the date format for displaying messages. 


To change the date format, the option "Apply project settings" must be deactivated or 
"ApplyProjectSettings" must be set to "FALSE". 


The following date formats are available: 


Explanation 
Automatic The date format is set automatically. 
dd.MM.yy Day.Month. Year, e.g. 24.12.07. 
dd.MM.yyyy Day.Month. Year, e.g. 24.12.2007. 
dd/MM/yy Day/Month/Year, e.g. 24/12/07. 
dd/MM/yyyy Day/Month/Year, e.g. 24/12/2007. 


The attribute can be assigned dynamic properties by means of the name 
MessageBlockDateFormat. The data type is STRING. 
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MessageBlockExponentialFormat property 


Exponential notation - MessageBlockExponentialFormat 


Specifies the exponential notation for visualization of the values of a selected message block. 


Value Explanation 
TRUE The values are displayed with exponential notation. 
FALSE The values are displayed with decimal notation. 


The attribute can be assigned dynamic properties by means of the name 
MessageBlockExponentialFormat. The data type is BOOLEAN. 


MessageBlockFlashMode property 


Flash mode - MessageBlockFlashMode 


Specifies how the content of the selected message block flashes in Runtime when a message 
appears. The "Flashing on" option must be selected. 


To change the setting, the option "Apply project settings" must be deactivated or 
"ApplyProjectSettings" must be set to "FALSE". 


Val- | Description Explanation 

ue 

0 Standard The text color switches between the standard color and the flash color when flashing 

1 Switch back- The color of the background and the text color switch during flashing. You configure the message 
ground color/text | colors for the type of message in the alarm logging editor. 
color 

2 Switch message | The message colors and the configured table colors switch during flashing. You configure the 
color/table color | message colors for the type of message in the alarm logging editor. Set the table colors in the 

"Layout" tab in the AlarmControl. 


The attribute can be assigned dynamic properties by means of the name 
MessageBlockFlashMode. The data type is LONG. 


MessageBlockFlashOn property 


Flashing on - MessageBlockFlashOn 


Enables flashing of the selected message block in Runtime after a message was activated. 


To change the setting, the option "Apply project settings" must be deactivated or 
"ApplyProjectSettings" must be set to "FALSE". 


Value Explanation 
TRUE Flashing message block content. 
FALSE No flashing message block content. 
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The attribute can be assigned dynamic properties by means of the name 
MessageBlockFlashOn. The data type is BOOLEAN. 


MessageBlockHideText property 


Content as text - MessageBlockHideText 


Enables the textual display of the content of a selected message block. 


Value Explanation 
TRUE The content is not displayed in text format. The option is disabled. 
FALSE The content is displayed in text format. The option is enabled. 


The attribute can be assigned dynamic properties by means of the name 
MessageBlockHideText. The data type is BOOLEAN. 


MessageBlockHideTitleText property 


Title as text - MessageBlockHideTitleText 


Enables the display of the header of a selected message block in text format. 


Value Explanation 
TRUE The header is not displayed in text format. The option is disabled. 
FALSE The header is displayed in text format. The option is enabled. 


The attribute can be assigned dynamic properties by means of the name 
MessageBlockHideTitleText. The data type is BOOLEAN. 


MessageBlockid property 


MessageBlockld 
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Default assignment of the ID number and message block in WinCC AlarmControl. 


The attribute can be assigned dynamic properties by means of the name MessageBlockID. 
The data type is LONG. 
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MessageBlockinvertUseMessageColor property 


MessageBlockinvertUseMessageColor 
Specifies for the message block whether or not the message colors are displayed, contrary to 
the central setting for the AlarmControl . For example, the "UseMessageColor" property is set 
to "FALSE" for the AlarmControl. You have set the "MessageBlockInvertUseMessageColor" 
property to "TRUE" for a message block. This causes the message colors to be displayed for 
this message block in Runtime. 


Value Explanation 

TRUE Contrary to the central setting in "UseMessageColor", the message colors are displayed or not displayed 
for the message block. 

FALSE Just like the central setting in "UseMessageColor", the message colors are displayed or not displayed 
for the message block. 


The attribute can be assigned dynamic properties by means of the name 
MessageBlockinvertUseMessageColor. The data type is BOOLEAN. 


MessageBlockindex property 


MessageBlockindex 
References an existing message block. Using this attribute, you can assign a specific message 
block values for other attributes. 


Values between 0 and "MessageBlockCount" minus 1 are valid for "MessageBlockIndex". 
Attribute "MessageBlockCount" defines the number of available message blocks. 


The attribute can be assigned dynamic properties by means of the name 
MessageBlockindex. The data type is LONG. 


MessageBlockLeadingZeros property 


Number of digits - MessageBlockLeadingZeros 
Defines the number of leading zeros for the message block content. The maximum number is 
"11". A "0" value deactivates the "With leading zeros" option. 


To change the setting, the option "Apply project settings" must be deactivated or 
"ApplyProjectSettings" must be set to "FALSE". 


The attribute can be assigned dynamic properties by means of the name 
MessageBlockLeadingZeros. The data type is LONG. 
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MessageBlockLength property 


Length in characters - MessageBlockLength 
Defines the length of the message block selected based on the number of characters. 


To change the length, the option "Apply project settings" must be deactivated or 
"ApplyProjectSettings" must be set to "FALSE". 


The attribute can be assigned dynamic properties by means of the name 
MessageBlockLength. The data type is LONG. 


MessageBlockName property 


Object name - MessageBlockName 
Displays the object name of the message block selected. You cannot edit this name. 
The data type is STRING. 


MessageBlockPrecisions property 


Decimal places - MessageBlockPrecisions 


Specifies the decimal precision of the values of a selected message block. You can only enter 
the value if the "Automatic" option is disabled. 


The attribute can be assigned dynamic properties by means of the name 
MessageBlockPrecisions. The data type is SHORT. 


MessageBlockSelected property 


Available message blocks - MessageBlockSelected 


The available message blocks are blocks that can be used in Runtime for the message list or 
hitlist. 


Select the "Message blocks" tab to activate existing message blocks as required in the Control. 
Select the "Hitlist" and "Message list" tabs to configure the hitlist and message list based on 
the available blocks. 


To change the setting, the option "Apply project settings" must be deactivated or 
"ApplyProjectSettings" must be set to "FALSE". 


The attribute can be assigned dynamic properties by means of the name 
MessageBlockSelected. The data type is BOOLEAN. 
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MessageBlockShowDate property 


Show date - MessageBlockShowDate 


Enables the display of a date in the "Time" message block in addition to the time. 


Value Explanation 
TRUE Date and time are displayed. 
FALSE The time is displayed. 


The attribute can be assigned dynamic properties by means of the name 
MessageBlockShowDate. The data type is BOOLEAN. 


MessageBlockShowlcon property 


Content as icon - MessageBlockShowlcon 


Enables the display of the content of a selected message block as icon. 


Value Explanation 
TRUE The content is visualized as icon. 
FALSE The content is not visualized as icon. 


The attribute can be assigned dynamic properties by means of the name 
MessageBlockShowlcon. The data type is BOOLEAN. 


MessageBlockShowTitlelcon property 


Title as icon - MessageBlockShowTitlelcon 


Enables the display of the title of a selected message block as icon. 


Value Explanation 
TRUE The header is displayed as icon. 
FALSE The header is not displayed as icon. 


The attribute can be assigned dynamic properties by means of the name 
MessageBlockShowTitlelcon. The data type is BOOLEAN. 


MessageBlockTextld property 


Text ID - MessageBlockTextlid 


Specifies the caption of the selected message block using a Text ID which was derived from 
the text library. The caption is adapted automatically if a user changes the Runtime language. 
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To change the setting, the option "Apply project settings" must be deactivated or 
"ApplyProjectSettings" must be set to "FALSE". 


The attribute can be assigned dynamic properties by means of the name 
MessageBlockTextld. The data type is LONG. 


MessageBlockTimeFormat property 


MessageBlockTimeFormat 


Defines which time format or duration format is used for displaying the messages. 


To change the setting, the option "Apply project settings" must be deactivated or 
"ApplyProjectSettings" must be set to "FALSE". 


The following time formats are available: 


Value Explanation 
Automatic The time format is set automatically. 
HH:mm:ss Hours:Minutes:Seconds, e.g. 15:35:44 


HH:mm:ss.ms 


Hours:Minutes:Seconds.Milliseconds, e.g. 15:35:44.240. 


hh:mmiss tt 


Hours:Minutes:Seconds AM/PM, e.g. 03:35:44 PM. 


hh:mm:ss.ms tt 


Hours:Minutes:Seconds.Milliseconds AM/PM, e.g. 03:35:44.240 PM. 


The following time duration formats are available: 


Value Explanation 

Automatic The time duration format is determined automatically. 
d H:mm:ss Day Hours:Minutes:Seconds, e.g. 1 2:03:55. 
H:mmi:ss. Hours:Minutes:Seconds, e.g. 26:03:55. 

m:ss Minutes:Seconds, Example: 1563:55. 


Ss 


Seconds, e.g. 93835. 


The attribute can be made dynamic by means of the name MessageBlockTimeFormat. The 
data type is STRING. 


MessageBlockType property 


MessageBlockT ype 


Displays the association of the message block. 


The following settings are available: 


Value Description Explanation 
0 System block The message block belongs to the system block category. 
1 Text block The message block belongs to the user text block category. 
2 Process value block The message block belongs to the process value block category. 
3 Hitlist block The message block belongs to the message blocks of the hitlist. 
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The attribute can be assigned dynamic properties by means of the name 
MessageBlockType . The data type is LONG. 


MessageClass Property 


Description 


See also 


Defines the respective message type (Alarm High, Alarm Low, Warning High, Warning Low, ...) 
for which the "Display Text", "Arrived-", "Arrived Acknowledged -" and "Departed 
Unacknowledged -" settings have been configured. 


Group Display (Page 194) 
Screenltem Object (Page 125) 


MessageColumnAdd property 


MessageColumnAdd 


Adds the selected message block from the list of existing message blocks to the list of selected 
message blocks. 


The attribute can be assigned dynamic properties by means of the name 
MessageColumndAdd . The data type is STRING. 


MessageColumnAutoAdjust property 


See also 


MessageColumnAutoAdjust 


Automatically optimizes the width of the columns in the WinCC AlarmControl in Runtime. If the 
configured column is not sufficient for the displayed text, the column width is increased. 


If the user changes the width of columns in Runtime, the width is only optimized again when 
the picture is opened again. 


The attribute can be assigned dynamic properties using the name 
MessageColumnAutoAdjust . The data type is BOOLEAN. 


MessageColumn object (list) (Page 223) 
WinCC AlarmControl (Page 241) 
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MessageColumnCount property 


MessageColumnCount 
Specifies the number of message blocks to be displayed in the message list in Runtime. 


The attribute can be assigned dynamic properties by means of the name 
MessageColumnCount . The data type is LONG. 


MessageColumnIndex property 


MessageColumnIndex 


References a message block selected for the message list. Using this attribute you can assign 
the values of other attributes to a specific message block of the message list. 


Values between 0 and "MessageColumnCount" minus 1 are valid for "MessageColumnIndex". 
Attribute "MessageColumnCount" defines the number of message blocks selected for the 
message list. 


The "MessageColumnIndex" attribute can be assigned dynamic properties by means of 
attribute MessageColumnRepos. The data type is LONG. 


MessageColumnName property 


MessageColumnName 


Displays the name of the message block of the message list which is referenced with attribute 
"MessageColumnIndex". You cannot edit this name. 


The attribute can be assigned dynamic properties with the name MessageColumnName. The 
data type is STRING. 


MessageColumnRemove property 


MessageColumnRemove 


Cuts the marked message block from the list of selected message blocks and pastes it to the 
list of available message blocks. 


The attribute can be assigned dynamic properties by means of the name 
MessageColumnRemove . The data type is STRING. 
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MessageColumnRepos property 


Up/Down - MessageColumnRepos/HitlistColumnRepos 


Resorts the message blocks. The "Up" and "Down" commands move the selected message 
block accordingly in the list. This moves the message block in Runtime Control towards the 
front or towards the back. 


The attribute for the hitlist can be assigned dynamic properties by means of the name 
HitlistColumnRepos . 


The attribute for the message list can be assigned dynamic properties by means of the name 
MessageColumnRepos. 


The data type is LONG. 
MessageColumnSort property 
MessageColumnSort 


Defines the sorting order of the message block referenced in "MessageColumnindex" . 


The following settings are available: 


Value Description Explanation 

0 no No sorting 

1 Ascending Ascending order, starting at the lowest value. 

2 Descending Descending order, starting at the highest value. 


The attribute can be assigned dynamic properties by means of the name 
MessageColumnSort . The data type is LONG. 


MessageColumnSortIndex property 


MessageColumnSortindex 


Defines the sorting order of the message block referenced in "MessageColumnindex". The 
sorting criterion is removed from "MessageColumnSort" if you set a "0" value. 


The attribute can be assigned dynamic properties by means of the name 
MessageColumnSortIndex. The data type is LONG. 


MessageColumnVisible property 


Selected message blocks - MessageColumnVisible/HitlistColumnVisible 


Selected message blocks of message list or hitlist that are displayed in Runtime. Defines 
whether the message block referenced in "MessageColumnIndex" or "HitlistColumnIndex" is 
displayed. 
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The attribute for the message list can be assigned dynamic properties by means of the name 
MessageColumn Visible. 


The attribute for the hitlist can be assigned dynamic properties by means of the name 
HitlistColumnVisible. 


The data type is BOOLEAN. 


MessageListType property 


Active list on picture call - MessageListType 


Mi - Ms 


Min Property 


Description 


See also 
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Selection field for defining the active list for picture calls. 


Description Explanation 
Message list The currently active messages are displayed after a picture was 
called. 


Short-term archive list | A short-term archive list displays the logged messages after the 
picture was called. The display is updated immediately on activation 
of new messages. 


Long-term archive list | Along-term archive list displays the logged messages after a picture 


was called. 

Lock list Only the currently locked messages are displayed after a picture 
was Called. 

Hitlist The configured statistics data is displayed after a picture was called. 


List of messages to be | The messages to be hidden are displayed at the call of a picture. 
hidden 


The attribute can be assigned dynamic properties by means of the name MessageListType. 
The data type is LONG. 


Defines or returns the absolute value in the case of the smallest value display. This value is 
displayed if the scale display is active. 


Slider (Page 212) 

Bar (Page 174) 

3D Bar (Page 169) 
Screenltem Object (Page 125) 
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MinuteNeedleHeight Property 


Description 


See also 


Defines or returns the length of the minute hand for the analog clock. The specification of the 
length is entered as a percentage value in relation to half the length of the short side of the 
rectangular background. Write/Read access. 


Example: 

The shorter side of the rectangular background is 100 pixels long. 

The minute hand length is 80. 

This results in a length of the minute hand of (100 pixels / 2) * 0.8 = 40 pixels. 


WinCC Digital/Analog Clock (Page 246) 
Screenltem Object (Page 125) 


MinuteNeedleWidth Property 


Description 
Defines or returns the width of the minute hand for the analog clock. The width is specified as 
a percentage value related to double the length of the minute hand. 
Example: 
The length of the minute hand is 40 pixels. 
The minute hand width is 8. 
This results in a width of the minute hand of 40 pixels * 2 * 0.08 = 6 pixels. 
See also 
WinCC Digital/Analog Clock (Page 246) 
Screenltem Object (Page 125) 
Moveable Property 
Description 
TRUE, when the object can be moved in Runtime. Read only access. 
See also 


Picture Window (Page 179) 
Application Window (Page 173) 
Screenltem Object (Page 125) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 507 


VBS for Creating Procedures and Actions 


7.14 VBS Reference 


Moveable Property 


Movable 


Defines whether the control can be moved in Runtime. 


Value Explanation 
TRUE The control can be moved in Runtime. 
FALSE The control cannot be moved in Runtime. 


The attribute can be assigned dynamic properties by means of the name Moveable. The data 
type is BOOLEAN. 


MsgCtriFlags Property 


Description 


See also 


Defines the sorting sequence in Alarm Control. Write/Read access. 


e 0: The entries are sorted by the value in the time column and in ascending order, i.e. the 
oldest messages are displayed at the top of the message window. 


e 1: The entries are sorted by the value in the time column in descending order, i.e. the oldest 
messages are displayed at the bottom of the message window. In the case of this value, 
the "AutoScroll" property is automatically deactivated, otherwise the current message could 
be moved out of the display area of the message window. 


WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 


MsgFilterSQL property (before WinCC V7) 


Description 


See also 


508 


Defines an SQL Statement to the selected messages displayed in the message window. Write/ 
Read access. 


WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 
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MsgFilterSQL property 


MsgFilterSQL 


Defines one or several SQL statements for the custom selection of messages. Multiple user- 
defined selections are logically linked by "OR" operation. The SQL statements of 
"DefaultMsgFilterSQL" and "MsgFilterSQL" are linked logically by "AND" operation if you 
define a default selection by means of "DefaultMsgFilterSQL". 


The attribute can be assigned dynamic properties by means of the name MsgFilterSQL. The 
data type is STRING. 


1.14.4.13 N 


Name Property 


Description of layer and tag object 
Returns the object name. STRING (read only) 
e Inthe case of tags, the name of the tag without server and tag prefix 


e Inthe case of layers, the layer name 


Tags 


The tag "Name" property is used to address the tag via the tag list. The name of a tag can 
contain a server prefix. In WinCC, tag names are structured according to the following scheme: 


<Serverprefix>::<Variablenprefix><Name der Variable> 


If the tag name alone is specified, the server prefix and tag prefix are removed from the context 
of the picture. 


If the tag is specified with a server prefix in the tag name, the tags and server prefix of the 
context are ignored and the server prefix included is used. 


WinCC Function Trend Control Description 
The "Index" property references a trend. "Name" defines the name of the trend. 


Description Project Object 
Returns the name of the current Runtime project. STRING (read only) 


Example: 
The following example returns the name of the current Runtime project as Trace: 


'VBS160 
HMIRuntime.Trace "Name: " & HMIRuntime.ActiveProject.Name & vbNewLin 
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Description of Dataltem Object 


Returns the name of the Dataltem object. 


See also 
ActiveProject Property (Page 303) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Tag Object (Page 137) 
Ellipse segment (Page 147) 
Layer Object (Page 120) 
Dataltem Object (Page 113) 
NeedleColor Property 
Description 
Defines or returns the color of the pointer. LONG write-read access. 
See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 
NormalColor Property 
Description 
Defines the color of the normal area of the scale. LONG write-read access. 
See also 


WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 
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NumberLines Property 


Description 


Text list 

Defines the number of lines the text list object should contain or returns the value. If the amount 
of configured text is larger than this value, the selection list receives a vertical scroll bar. 
Combo box and list box 


Defines the number of lines the combo box and list field object should contain or returns the 
value. You can set a maximum of 32 000 lines. 


At the same time, the value of the "Number of rows" attribute specifies the high limit for the 
"Index" attribute in the "Font" property group. Changing the value can have the following 
effects: 


e Increasing the number: New lines are added at the bottom. The standard labeling of the 
new field can be changed using the "Text" attribute in the "Font" property group. 


@ Reducing the number: All lines are removed for which the value of the "Index" attribute is 
higher than the new number. 


See also 
Text list (Page 196) 
Screenltem Object (Page 125) 
Numltems Property 
Description 
Returns the number of trends or column pairs (visible and invisible) in the window which have 
been configured. Write/Read access. 
See also 


WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
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1.14.4.14 O 
Ob - On 
Object Property 
Description 
If anon-WinCC control is used, it is possible that the properties provided by the control have 
the same names as the general Screenltem properties. In such cases, the Screenltem 
properties have priority. The "hidden" properties of an external control supplier can be 
accessed using the additional "object" property. 
Example: 
Address the properties of an external control supplier as follows: 
Control.object.type 
If the following form alone is used 
Control.type 
the properties of the Screenltem object are used in the case of identical names. 
See also 
Controls (Page 218) 
Screenltem Object (Page 125) 
ObjectName Property 
Description 
Returns the object name. 
@ Inthe case of graphic objects, the object name 
e Inthe case of pictures, the picture name 
STRING (read only) 
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Example: 
The following example issues the names of all the objects contained in the picture "NewPDL1": 


"VBS80 

Dim objScreen 

Dim lngIndex 

Dim lngAnswer 

Dim strName 

IngIndex = 1 

Set objScreen = HMTRuntime.Screens ("NewPDL1") 


For IngIndex = 1 To objScreen.ScreenItems.Count 
strName = objScreen.ScreenItems.Item(lngIndex) .ObjectNam 
IngAnswer = MsgBox("Name of object " & IngIndex & ": " & strName, vbOKCancel) 
If vbCancel = lngAnswer Then Exit For 
Next 
Pictures 


Establish the picture name directly from the "ObjectName" property: 


"VBS81 
MsgBox "Screenname: " & HMIRuntime.ActiveScreen.ObjectNam 


See also 
Screen Object (Page 131) 
Screenltem Object (Page 125) 


ObjectSizeDeclutteringEnable Property 


Description 
Returns the ObjectSizeDecluttering properties of a picture. 
Upon activated ObjectSizeDecluttering, only objects within a set size range are displayed. 


You specify the upper and lower limits for the display range in Graphics Designer under "Tools> 
Settings > Show/Hide". 


BOOLEAN Read-only access. 
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Example: 
The example outputs the Decluttering Properties of the picture NewPDL1 as a trace. 


"VBS157 


Dim objScreen 
Set objScreen = HMTRuntime.Screens ("NewPDL1") 
""& objScreen.ObjectSizeDeclutteringMin & vbNewLine 


HMIRuntime.Trace "Min: 
HMIRuntime.Trace "Max: " & objScreen.ObjectSizeDeclutteringMax & vbNewLine 
HMTRuntime.Trace "Enable: " & objScreen.LayerDeclutteringEnable & vbNewLine 


See also 
Screen Object (Page 131) 


ObjectSizeDeclutteringMax Property 


Description 
Using the ObjectSizeDeclutteringMax property, the upper size range of a picture may be read. 
Objects which are larger than the stated pixel size are no longer displayed when 
ObjectSizeDecluttering is activated. 
LONG read-only access. 

Example: 
The example outputs the Decluttering Properties of the picture NewPDL1 as a trace. 

'VBS157 


Dim objScreen 
Set objScreen = HMTRuntime.Screens ("NewPDL1") 
""& objScreen.ObjectSizeDeclutteringMin & vbNewLine 


HMTIRuntime.Trace "Min: 
HMIRuntime.Trace "Max: " & objScreen.ObjectSizeDeclutteringMax & vbNewLine 
HMTIRuntime.Trace "Enable: " & objScreen.LayerDeclutteringEnable & vbNewLine 


See also 
Screen Object (Page 131) 
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ObjectSizeDeclutteringMin Property 


Description 
Using the ObjectSizeDeclutteringMin property, the lower size range of a picture may be read. 
Objects which are smaller than the stated pixel size are no longer displayed when 
ObjectSizeDecluttering is activated. 
LONG read-only access. 

Example: 
The example outputs the Decluttering Properties of the picture NewPDL1 as a trace. 

"VBS157 


Dim objScreen 
Set objScreen = HMTRuntime.Screens ("NewPDL1") 


HMIRuntime.Trace "Min: " & objScreen.ObjectSizeDeclutteringMin & vbNewLine 
HMIRuntime.Trace "Max: " & objScreen.ObjectSizeDeclutteringMax & vbNewLine 
HMTRuntime.Trace "Enable: " & objScreen.LayerDeclutteringEnable & vbNewLine 


See also 
Screen Object (Page 131) 
OffsetLeft Property 
Description 
Defines or returns the distance of the picture from the left edge of the picture window. 
The picture is displayed as a cutout of the picture window. The picture scroll bars are located 
at the left and upper edge of the picture. If you wish to display the picture in the picture window 
by using the horizontal and vertical positioning of the picture scroll bars, use the properties 
"ScrollPositionX" and "ScrollPositionY" for such positioning. 
See also 
ScrollPositionY Property (Page 562) 
ScrollPositionX Property (Page 562) 
Picture Window (Page 179) 
Screenltem Object (Page 125) 
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OffsetTop Property 


Description 


See also 


OneY Property 


Description 


Defines or returns the distance of the picture from the top edge of the picture window. 


The picture is displayed as a cutout of the picture window. The picture scroll bars are located 
at the left and upper edge of the picture. If you wish to display the picture in the picture window 
by using the horizontal and vertical positioning of the picture scroll bars, use the properties 
"ScrollPositionX" and "ScrollPositionY" for such positioning. 


ScrollPositionY Property (Page 562) 
ScrollPositionX Property (Page 562) 
Picture Window (Page 179) 
Screenltem Object (Page 125) 


TRUE if only the Y-axis of the trend is displayed in the foreground instead of all Y-axes of the 
displayed trends. BOOLEAN write-read access. 


Online property (before WinCC V7) 


Description 


See also 
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Serves to start or stop updating. 


e 0: The updated display is stopped. The values are buffered and updated when the button 
is clicked again. 


e -1: The updated display is resumed. 


Screenltem Object (Page 125) 

WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
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Online property 


Starting refresh - Online 


Enables a refresh of displayed values when calling a picture in Runtime. 


Value Description 
TRUE Enables the refresh of values on picture calls. 
FALSE Disables the refresh of values on picture calls. 
The attribute can be assigned dynamic properties by means of the name Online. The data 
type is BOOLEAN. 
OnTop Property 
Description 
TRUE, when the object should remain in the foreground in Runtime. Read only access. 
See also 
Picture Window (Page 179) 
Application Window (Page 173) 
Screenltem Object (Page 125) 
Op 


OperationMessage Property 


Description 


See also 


TRUE, if a message should be output upon successful operation. BOOLEAN Schreib-Lese- 
Zugriff. 

The operation is sent to the message system, and is archived. Using the message system, a 
message may be output in a message line, for example. 

Special features of I/O field, text list and slider 


The reason for the operation may only be entered if the "OperationReport" property has been 
set to TRUE. 


Slider (Page 212) 
Text list (Page 196) 
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Radio box (Page 207) 

Check box (Page 204) 

I/O Field (Page 184) 
Screenltem Object (Page 125) 


OperatorMessagelD property 


OperatorMessagelD 
Default assignment of the ID number and trigger event in WinCC OnlineTableControl: 


Value Description Explanation 
5 EditValue Trigger event "Change archive value" 
6 InsertValue Trigger event "Generate archive value" 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageID. The data type is LONG. 


OperatorMessagelndex property 


OperatorMessagelndex 


References the event of an archive value change for an operator message. Using this attribute 
you can assign the values of other attributes to a specific operator message. 


The following values are available: 


Value Explanation 
0 Trigger event "Change archive value" 
1 Trigger event "Generate archive value" 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessagelndex. The data type is LONG. 


OperatorMessageName property 


Object name - OperatorMessageName 


Displays the name that is referenced with the attribute "OperatorMessagelndex" for message 
events for operator messages. You cannot edit this name. 


The following names are available for message events: 


Value Explanation 
Lock Message event "Lock" 
Unlock Message event "Enable" 
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Value Explanation 

Hide Message event "Hide" 
Unhide Message event "Unhide" 
Quit Message event "Ackn." 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageName . The data type is STRING. 


OperatorMessageNumber property 


Message number - OperatorMessageNumber 


Define a message number for the selected operator message event if you do not want to use 
the operator message of WinCC. 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageNumber. The data type is LONG. 


OperatorMessageSelected property 


Operator messages for - OperatorMessageSelected 
Activate the message events which trigger operator messages in the list. 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageSelected. The data type is BOOLEAN. 


OperatorMessageSource1 property 


Source - OperatorMessageSource1 


Define the message block of an operated message to be added to "Process value block 1" of 
the operator message configured in Source. 


An operator message is to be generated to indicate that a message was locked. The contents 
of "User text block 1" of the locked message, e.g. "Motor faulty", is to be displayed in "Process 
value block 1" of the operator message. Select "1" at process value as the message lock of 
the operated message "User text block 1". 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageSource1. The data type is STRING. 


OperatorMessageSource2 property 


Source - OperatorMessageSource2 


Define the message block of an operated message to be added to "Process value block 2" of 
the operator message configured in Source. 
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An operator message is to be generated to indicate that a message was locked. The contents 
of "User text block 1" of the locked message, e.g. "Motor faulty", is to be displayed in "Process 
value block 2" of the operator message. Select "2" at process value as the message lock of 
the operated message "User text block 1". 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageSourcez2. The data type is STRING. 


OperatorMessageSource3 property 


Source - OperatorMessageSource3 


Define the message block of an operated message to be added to "Process value block 3" of 
the operator message configured in Source. 


An operator message is to be generated to indicate that a message was locked. The contents 
of "User text block 1" of the locked message, e.g. "Motor faulty", is to be displayed in "Process 
value block 3" of the operator message. Select "3" at process value as the message lock of 
the operated message "User text block 1". 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageSource3. The data type is STRING. 


OperatorMessageSource4 property 


Source - OperatorMessageSource4 


Define the message block of an operated message to be added to "Process value block 4" of 
the operator message configured in Source. 


An operator message is to be generated to indicate that a message was locked. The contents 
of "User text block 1" of the locked message, e.g. "Motor faulty", is to be displayed in "Process 
value block 4" of the operator message. Select "4" at process value as the message lock of 
the operated message "User text block 1". 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageSource4. The data type is STRING. 


OperatorMessageSourced property 


Source - OperatorMessageSource5 
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Define the message block of an operated message to be added to "Process value block 5" of 
the operator message configured in Source. 


An operator message is to be generated to indicate that a message was locked. The contents 
of "User text block 1" of the locked message, e.g. "Motor faulty", is to be displayed in "Process 
value block 5" of the operator message. Select "5" at process value as the message lock of 
the operated message "User text block 1". 
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The attribute can be assigned dynamic properties by means of the name 
OperatorMessageSource5. The data type is STRING. 


OperatorMessageSource6 property 


Source - OperatorMessageSource6 


Define the message block of an operated message to be added to "Process value block 6" of 
the operator message configured in Source. 


An operator message is to be generated to indicate that a message was locked. The contents 
of "User text block 1" of the locked message, e.g. "Motor faulty", is to be displayed in "Process 
value block 6" of the operator message. Select "6" at process value as the message lock of 
the operated message "User text block 1". 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageSource6. The data type is STRING. 


OperatorMessageSource7 property 


Source - OperatorMessageSource7 


Define the message block of an operated message to be added to "Process value block 7" of 
the operator message configured in Source. 


An operator message is to be generated to indicate that a message was locked. The contents 
of "User text block 1" of the locked message, e.g. "Motor faulty", is to be displayed in "Process 
value block 7" of the operator message. Select "7" at process value as the message lock of 
the operated message "User text block 1". 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageSource’7. The data type is STRING. 


OperatorMessageSource8 property 


Source - OperatorMessageSource8 


Define the message block of an operated message to be added to "Process value block 8" of 
the operator message configured in Source. 


An operator message is to be generated to indicate that a message was locked. The contents 
of "User text block 1" of the locked message, e.g. "Motor faulty", is to be displayed in "Process 
value block 8" of the operator message. Select "8" at process value as the message lock of 
the operated message "User text block 1". 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageSource®8. The data type is STRING. 
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OperatorMessageSource9 property 


Source - OperatorMessageSource9 


Define the message block of an operated message to be added to "Process value block 9" of 
the operator message configured in Source. 


An operator message is to be generated to indicate that a message was locked. The contents 
of "User text block 1" of the locked message, e.g. "Motor faulty", is to be displayed in "Process 
value block 9" of the operator message. Select "9" at process value as the message lock of 
the operated message "User text block 1". 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageSource9. The data type is STRING. 


OperatorMessageSource10 property 


Source - OperatorMessageSource10 


Define the message block of an operated message to be added to "Process value block 10" 
of the operator message configured in Source. 


An operator message is to be generated to indicate that a message was locked. The contents 
of "User text block 1" of the locked message, e.g. "Motor faulty", is to be displayed in "Process 
value block 10" of the operator message. Select "10" at process value as the message lock of 
the operated message "User text block 1". 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageSource10. The data type is STRING. 


OperatorMessageSourceType’ property 


Transfer as - OperatorMessageSourceType’1 


Specifies the format of the source content for the transfer. 


The following formats are available: 


Value Description Explanation 
0 Text Transfer the source content in text format. 
1 Value Transfer the source content as value. 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageSourceType1. The data type is LONG. 


OperatorMessageSourceType2 property 


Transfer as - OperatorMessageSourceT ype2 
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Specifies the format of the source content for the transfer. 
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The following formats are available: 


Value Description Explanation 
0 Text Transfer the source content in text format. 
1 Value Transfer the source content as value. 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageSourceType2. The data type is LONG. 


OperatorMessageSourceType3 property 
Transfer as - OperatorMessageSourceType3 


Specifies the format of the source content for the transfer. 


The following formats are available: 


Value Description Explanation 
0 Text Transfer the source content in text format. 
1 Value Transfer the source content as value. 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageSourceType3. The data type is LONG. 


OperatorMessageSourceType4 property 
Transfer as - OperatorMessageSourceType4 


Specifies the format of the source content for the transfer. 


The following formats are available: 


Value Description Explanation 
0 Text Transfer the source content in text format. 
1 Value Transfer the source content as value. 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageSourceType4. The data type is LONG. 


OperatorMessageSourceType5d property 


Transfer as - OperatorMessageSourceType5 


Specifies the format of the source content for the transfer. 
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The following formats are available: 


Value Description Explanation 
0 Text Transfer the source content in text format. 
1 Value Transfer the source content as value. 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageSourceType5. The data type is LONG. 


OperatorMessageSourceType6 property 


Transfer as - OperatorMessageSourceType6 


Specifies the format of the source content for the transfer. 


The following formats are available: 


Value Description Explanation 
0) Text Transfer the source content in text format. 
1 Value Transfer the source content as value. 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageSourceType6. The data type is LONG. 


OperatorMessageSourceType7 property 


Transfer as - OperatorMessageSourceType7 


Specifies the format of the source content for the transfer. 


The following formats are available: 


Value Description 
0 Text 
1 Value 


Explanation 


Transfer the source content in text format. 
Transfer the source content as value. 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageSourceType7. The data type is LONG. 


OperatorMessageSourceType8 property 


Transfer as - OperatorMessageSourceType8 


Specifies the format of the source content for the transfer. 
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The following formats are available: 


Value Description Explanation 
0 Text Transfer the source content in text format. 
1 Value Transfer the source content as value. 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageSourceType8. The data type is LONG. 


OperatorMessageSourceType9 property 
Transfer as - OperatorMessageSourceType9 


Defines the format for transferring the source. 


The following formats are available: 


Value Description Explanation 
0 Text Transfer the source as text. 
1 Value Transfer the source as value. 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageSourceType9. The data type is LONG. 


OperatorMessageSourceType10 property 
Transfer as - OperatorMessageSourceType10 


Specifies the format of the source content for the transfer. 


The following formats are available: 


Value Description Explanation 
0 Text Transfer the source content in text format. 
1 Value Transfer the source content as value. 


The attribute can be assigned dynamic properties by means of the name 
OperatorMessageSourceType10. The data type is LONG. 


OperationReport Property 


Description 


TRUE, if the reason for an operation should be recorded. BOOLEAN write/read access. 
When the object is used or operated in Runtime, a dialog opens in which the operator can 
input the reason for the operation in the form of text. The operation is sent to the message 
system, and is archived. 
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See also 
Slider (Page 212) 
Text list (Page 196) 
I/O Field (Page 184) 
Screenltem Object (Page 125) 
Or - Ou 


Orientation Property 


Description 


TRUE, when the text in the object should be displayed horizontally. BOOLEAN write-read 
access. 


Description of the "Connector" object type 
Modifies the orientation of the connector. BOOLEAN write-read access. 


See also 
Connector (Page 167) 
Static text (Page 165) 
Text list (Page 196) 
Radio box (Page 207) 
Check box (Page 204) 
Button (Page 201) 
I/O Field (Page 184) 
Screenltem Object (Page 125) 


OuterBevelStyle Property 


Description 
Defines the 3D effect for the outer bevel of the object. 
e@ 0: No border. 
e 1: The border is displayed depressed. 
e@ 2: The border is displayed raised. 


e 3: The border is displayed in one color without a 3D effect. The border color is defined by 
the "BevelColorUp" property. 
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See also 
WinCC Slider Control (Page 277) 
Screenltem Object (Page 125) 


OuterBevelWidth Property 


Description 


Defines the width of the outer bevel in pixels. 
See also 
WinCC Slider Control (Page 277) 


Screenltem Object (Page 125) 


Outline Property 


Description 
TRUE, when the button should be given a black border in addition to the 3D border. BOOLEAN 
write-read access. 

See also 
WinCC Push Button Control (Page 269) 
Screenltem Object (Page 125) 

OutputFormat Property 

Description 
Returns the value for the representation of the output value and sets it. The representation 
depends on the data format. 

See also 


I/O Field (Page 184) 
Screenltem Object (Page 125) 
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OutputValue Property 


Description 


Determines the default setting for the value to be displayed or returns it. 
This value is used in Runtime when the associated tag cannot be connected or updated when 
a picture is started. 


See also 
Text list (Page 196) 
I/O Field (Page 184) 
Screenltem Object (Page 125) 
1.14.4.15 P 
Pa-Pe 
PageMode property 


Enable paging - PageMode 


Enables paging is in the long-term archive list. Allows you to display all messages of the short- 
term archive in the long-term archive list. Use the "Messages per page" or 
"PageModeMessageNumber" property to determine the number of messages displayed per 


page. 
The page up/down buttons of the toolbar can be used if paging is enabled. 


Value Explanation 
TRUE Paging is enabled for the long-term archive list. 
FALSE Paging is disabled for the long-term archive list. 


The attribute can be assigned dynamic properties by means of the name PageMode. The data 
type is BOOLEAN. 


PageModeMessageNumber property 


Messages per page - PageModeMessageNumber 
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Defines the number of messages shown per page when paging the long-term archive list. 


The attribute can be assigned dynamic properties by means of the name 
PageModeMessageNumber. The data type is LONG. 
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Parent Property 

Description 
Returns a reference to the superordinate object. 
Objects within the VBS object model are accessed by hierarchy. You may descend in the 
picture hierarchy using Screen and Screenitems. You may ascend in the picture hierarchy by 
using the Parent property. 

Usage 


The Parent property can be used as often as required within an object hierarchy. The following 
section provides a systematic description of how to access all the elements in a hierarchy: 


Picture window in the basic picture "GB" 


Picture window in the picture "Bild1" 


Circle "Circle1" 
in the picture "Bild2" 


Dim MyCircle 
Set MyCircle = ScreenItem("Circlei'™) 


MsgBox MyCircle.Parent.Parent.Parent.Parent.Parent.name ' 


The Command 


MsgBox MyCircle.Parent.Objectname 
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returns the name of "Picture2" located one layer higher in the object hierarchy than the original 
Screenltem object "Circle1". 


For example, if you wish to use "Parent" three times, ascend in the object hierarchy by three 
layers: 


MsgBox MyCircle.Parent. Parent. Parent.Objectname 
returns the name of Picture’. 

Reasoning: 

@ Original reference is to Screenltem "Circle1" 

e "Circle1" is within "Picture2" (Layer 1) 

e "Picture2" is within Picture Window2 "BF2" (Layer 2) 

@ "BF2" is within "Picture 1"(Layer 3) 


Example 
In the following examples, the object name of the parent object is displayed: 
'VBS120 
Dim objCircle 
Set objCircle = HMTRuntime.Screens ("ScreenWindowl") .ScreenItems ("Circlel") 


MsgBox objCircle.Parent.ObjectNam 


"VBS82 

Dim objScriItem 

Set objScrItem = HMIRuntime.Screens(1).ScreenItems (1) 
MsgBox "Name of BaseScreen: " & objScriItem.Parent.ObjectNam 


See also 
Picture Window (Page 179) 
Screen Object (Page 131) 
Objects and Lists (Page 107) 


PasswordLevel Property 


Description 
Defines the authorization for operation (e.g. no input or no triggering actions) of the object. 
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See also 
Screenltem Object (Page 125) 

Path Property 

Description 
Returns the path of the current project (without file name). For a WinCC client without its own 
path, the path is returned in UNC format, otherwise the local path is returned. 
STRING (read access only) 

Example: 
The following example returns the project path as Trace: 

'VBS161 

HMTIRuntime.Trace "Path: " & HMIRuntime.ActiveProject.Path & vbNewLine 

See also 
Project Object (Page 124) 

PercentageAxis property 

PercentageAxis 
Specifies whether an axis with percentage scaling will be displayed in addition to the value 
axes in the trend window or diagram window. 

Value Explanation 

TRUE The display of an axis with percentage scaling is enabled. 

FALSE The display of an axis with percentage scaling is disabled. 


The attribute can be assigned dynamic properties by means of the name PercentageAxis. The 
data type is BOOLEAN. 


PercentageAxisAlign property 


PercentageAxisAlign 


Specifies the alignment of the axis with percentage scaling in the trend window or diagram 
window. 
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The following settings are available: 


Value Description Explanation 
0 left The axis with percentage scaling is aligned left. 
1 right The axis with percentage scaling is aligned right. 


The attribute can be assigned dynamic properties by means of the name 
PercentageAxisAlign. The data type is LONG. 


PercentageAxisColor property 


PercentageAxisColor 


Specifies the color of an axis with percentage scaling. The button opens the "Color selection" 
dialog to select the color. 


The attribute can be assigned dynamic properties by means of the name 
PercentageAxisColor. The data type is LONG. 


PersistentRT Property 


Description 


TRUE, when modified window settings should be retained following a change of picture. 
Whether the information is evaluated is dependent on the value of the "AllowPersistance" 


property. 

See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 

PersistentRTCS Property 

Description 


TRUE, when modified settings should be retained following a change of picture and applied 
in the configuration system. Whether the information is evaluated is dependent on the value 
of the "AllowPersistance" property. BOOLEAN write-read access. 
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WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


PersistentRTCSPermission Property 


Description 


See also 


Defines the operator permission which is necessary in order to modify settings related to 
persistence. The value to be entered must correspond to the number of the requested 
authorization level in the user administrator. Whether or not the information is to be analyzed 
depends on the value of the "AllowPersistence" property (does not apply to WinCC Alarm 
Control). 


WinCC Alarm Control (before WinCC V7) (Page 286) 

WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


PersistentRTPermission Property 


Description 


See also 


Defines the operator permission which is necessary in order to modify settings related to the 
persistency in Runtime. The value to be entered must correspond to the number of the 
requested authorization level in the user administrator. Whether or not the information is to be 
analyzed depends on the value of the "AllowPersistence" property (does not apply to WinCC 
Alarm Control). 


WinCC Alarm Control (before WinCC V7) (Page 286) 

WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
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Pi 


PicDeactReferenced-Eigenschaft 


Description 


TRUE, when the picture assigned for the "Disable" status should be saved in the RoundButton 
object. Otherwise, only the associated object reference is saved. Read only access. 


See also 
Round Button (Page 209) 
Screenltem Object (Page 125) 


PicDeactTransparent Property 


Description 
Defines or returns which color of the bitmap object (.bmp, .dib) assigned to the "Disabled" 
status should be set to "transparent". LONG Write/Read Access. 
The color is only set to "Transparent" if the value of the "PicDeactUseTransColor" property is 
"True". 

See also 


Round Button (Page 209) 
Screenltem Object (Page 125) 


PicDeactUseTransColor Property 


Description 


TRUE, when the transparent color defined by the "PicDeactTransparent" property for the 
"Disable" status should be used. BOOLEAN write-read access. 


See also 
Round Button (Page 209) 
Screenltem Object (Page 125) 
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PicDownReferenced Property 


Description 


TRUE, when the picture assigned for the "On" status is to be saved. Otherwise, only the 
associated object reference is saved. Read only access. 


See also 
Round Button (Page 209) 


Screenltem Object (Page 125) 


PicDownTransparent Property 


Description 
Defines or returns which color of the bitmap object (.bmp, .dib) assigned to the "On" status 
should be set to "transparent". LONG Write/Read Access. 
The color is only set to "Transparent" if the value of the "PicDownUseTransColor" property is 
"True". 

See also 


Round Button (Page 209) 
Screenltem Object (Page 125) 


PicDownUseTransColor Property 


Description 


TRUE, when the transparent color defined by the "PicDownTransparent" property for the "On" 
status should be used. BOOLEAN write-read access. 


See also 
Round Button (Page 209) 
Screenltem Object (Page 125) 


PicReferenced Property 


Description 


TRUE, when the assigned picture is references the object and is not saved in it. Read only 
access. 
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See also 
Graphic Object (Page 187) 
Screenltem Object (Page 125) 


PictAlignment property 


Description 
Defines or returns the picture alignment of the picture on the button or round button. 
LONG write-read access. 
PicTransColor Property 
Description 
Defines or returns which color of the assigned bitmap object (.bmp, .dib) should be set to 
"transparent". LONG Write/Read Access. 
The color is only set to "Transparent" if the value of the "PicUseTransColor" property is "True". 
See also 
Graphic Object (Page 187) 
Screenltem Object (Page 125) 
Picture Property 
Description 
Returns the picture name of the background picture for the rectangular background for both 
the analog and digital clocks. Read only access 
See also 
WinCC Digital/Analog Clock (Page 246) 
Screenltem Object (Page 125) 
PictureBack Property 
Description 


Returns the picture name of the picture for the object background. Read only access. 
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WinCC Slider Control (Page 277) 
Screenltem Object (Page 125) 


PictureDeactivated Property 


Description 
Defines the picture to be displayed in the "Disable" status or returns the picture name. 
The picture (*.BMP or *.DIB) must be located in the "GraCS" directory of the current project 
so that it can be integrated. 
See also 
Round Button (Page 209) 
Screenltem Object (Page 125) 
PictureDirectory property 


Directory for pictures (PictureDirectory) 


Specifies the name of the subdirectory that is created in the "GraCS" directory of the WinCC 
project. If pictures are stored in the subdirectory, they are available for the extended status 
display. If no subdirectory is specified or the subdirectory does not contain any pictures, the 
pictures in the "GraCS" directory are taken into consideration. 


The "Directory for pictures" attribute can be dynamized with the name "PictureDirectory". 


PictureDown Property 


Description 


See also 


Defines the picture to be displayed in the "On" status or returns the picture name. 
The picture (*.BMP or *.DIB) must be located in the "GraCS" directory of the current project 
so that it can be integrated. 


Button (Page 201) 
Round Button (Page 209) 
Screenltem Object (Page 125) 
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PictureName Property 


Description 
Defines the picture to be displayed in the graphic object in Runtime or returns the picture name. 
The picture (*.BMP or *.DIB) must be located in the "GraCS" directory of the current project 
so that it can be integrated. 

See also 


Graphic Object (Page 187) 
Screenltem Object (Page 125) 


PictureSelected Property 


Description 
Returns the picture name of the picture displayed in the "On" status. "AutoSize" controls the 
adaptation of the size of picture and buttons. Read only access. 
See also 
WinCC Push Button Control (Page 269) 
Screenltem Object (Page 125) 
PictureSizeMode property 
PictureSizeMode 
Specifies the size adjustment between picture and control. 
Value _ | Designation Explanation 
0 Fit size to content The control is adapted to the picture size. 
1 Fit content to size The picture is adapted or scaled to the control. 


The attribute can be assigned dynamic properties by means of the name PictureSizeMode. 
The data type is LONG. 


PictureThumb Property 
Description 


Returns the picture name of the background picture for the slider. Read only access. 
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See also 
WinCC Slider Control (Page 277) 
Screenltem Object (Page 125) 


PictureUnselected Property 


Description 
Returns the picture name of the picture displayed in the "Off" status. "AutoSize" controls the 
adaptation of the size of picture and buttons. Read only access. 
See also 
WinCC Push Button Control (Page 269) 
Screenltem Object (Page 125) 
PictureUp Property 
Description 
Defines the picture to be displayed in the "Off" status or returns the picture name. 
The picture (*.BMP or *.DIB) must be located in the "GraCS" directory of the current project 
so that it can be integrated. 
See also 


Round Button (Page 209) 
Button (Page 201) 
Screenltem Object (Page 125) 


PicUpReferenced Property 


Description 


TRUE, when the picture assigned for the "Off" status should be saved in the object. Otherwise, 
only the associated object reference is saved. Read only access. 


See also 
Round Button (Page 209) 
Screenltem Object (Page 125) 
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PicUpTransparent Property 


Description 
Defines or returns which color of the bitmap object (.bmp, .dib) assigned to the "Off" status 
should be set to "transparent". LONG Write/Read Access. 
The color is only set to "Transparent" if the value of the "PicUpUseTransColor" property is 
"True". 

See also 


Round Button (Page 209) 
Screenltem Object (Page 125) 


PicUpUseTransColor Property 


Description 
TRUE, when the transparent color defined by the "PicUpTransparent" property for "Off" status 
should be used. BOOLEAN write-read access. 

See also 
Round Button (Page 209) 
Screenltem Object (Page 125) 

PicUseTransColor Property 

Description 
TRUE, when the transparent color defined by the "PicDeactTransparent" property for the 
"Disable" status should be used. BOOLEAN write-read access. 

See also 


Graphic Object (Page 187) 
Screenltem Object (Page 125) 
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Pl- Pr 
PlayEndless property 
PlayEndless 
Specifies if movies are played endlessly in the control. 
The attribute can be assigned dynamic properties by means of the name PlayEndless. The 
data type is BOOLEAN. 
PointCount Property 
Description 
Defines or returns the number of corner points. Each corner point has position coordinates 
and is identified via an index. 
See also 


Polyline (Page 158) 
Polygon (Page 156) 
Screenltem Object (Page 125) 


Position Property 


Description 
Defines the presetting for the position of the slider. 
This value is used as the start value in Runtime. 
To operate the process value linked to this attribute, it is necessary that the process value is 
also linked to the "Position" event. You will find the event "Position" in the "Event" tab, in the 
topic tree under SliderCtrl\Property Topics\Control Properties\Value. 

See also 


WinCC Slider Control (Page 277) 
Screenltem Object (Page 125) 
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Precisions Property 


Description 
WinCC Online Trend Control 
The "Index" property references a pair of columns. "Precision" defines the number of decimal 
places which should be shown in this value column. A maximum of 16 decimal places can be 
displayed. 
WinCC Online Trend Control 
Defines the number of decimal places with which the scale value is specified. 
See also 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 
PrecisionX Property 
Description 
Defines or returns the number of decimal places with which the scale value for the X-axis 
should be specified. Write/Read access. 
See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
PrecisionY Property 
Description 
Defines or returns the number of decimal places with which the scale value for the Y-axis 
should be specified. Write/Read access. 
See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
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PredefinedAngles Property 


Description 
Defines or returns the depth of the display of the 3DBarGraph object. Value range from 0 to 3. 
0 = cavalier 
1 = isometric 
2 = axionometric 


3 = freely defined 


See also 
Screenltem Object (Page 125) 
3D Bar (Page 169) 


PreferredTarget property 
Preferred picture target (PreferredTarget) 
The "Preferred picture target" attribute specifies where the picture change is carried out by the 
Favorites browser. 


Yes The picture change is carried out in this picture screen. In the case of nested picture screens the picture change 
is carried out at the innermost picture screen with the "Yes" setting. 


No The picture change is carried out in the main screen. 


The "Preferred picture target" attribute can be made dynamic with the name "PreferredTarget". 


Pressed Property 


Description 
TRUE, when the Button or RoundButton object is pressed. BOOLEAN write-read access. 


See also 
Round Button (Page 209) 
Screenltem Object (Page 125) 


PrintBackgroundColor Property 


Description 


TRUE, if the defined background color is also printed while printing the controls. BOOLEAN 
write-read access. 
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PrintJob Property 


Description 
Defines or reads out which print layout should be used for the printed output. 


See also 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 

PrintJobName property 


Current print job view - PrintJobName 


Defines the print job triggered by the print function of the "Print" toolbar button. The 
recommended print job is set for the control by default. 


Open the "Select Print Job" dialog using the selection button. 


The attribute can be assigned dynamic properties by means of the name PrintJobName. The 
data type is STRING. 


Process Property 


Description 
Defines or returns presetting for the value to be displayed. 
This value is used in Runtime when the associated tag cannot be connected or updated when 
a picture is started. 

See also 


Slider (Page 212) 

Radio box (Page 207) 

Check box (Page 204) 

Bar (Page 174) 

3D Bar (Page 169) 
Screenltem Object (Page 125) 
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ProcessValue property 


Description 


Returns an object of type "ProcessValue". 


See also 
Alarms object (list) (Page 110) 


ProjectPath Property 


Description 


Contains the path and name of the associated project. 
See also 
WinCC Alarm Control (before WinCC V7) (Page 286) 


Screenltem Object (Page 125) 


ProviderClsid Property 


Description 
The "Index" property references a trend. "ProviderClsid" defines whether an archive tag or an 
internal or external tag should be displayed in this trend. 
e {416A09D2-8B5A-11D2-8B81-006097A45D48}: The trend is connected to an archive tag. 
e {A3F69593-8AB0-11D2-A440-O0OAOC9DBB64E}: The trend is connected to an internal or 

external tag. 

See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 

ProviderType Property 

Description 


Defines the type of values to be displayed in a trend referenced by "Index". In the case of 
modification of "ProviderType", impermissible combinations with other attributes for data 
connection could be created. Therefore, before modifying "ProviderType", the immediate 
acceptance of the changes must be prevented using "FreezeProviderConnections". 
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0: Values are supplied via the API interface. 
-1: Display of online or archive tags 


-2: Displaying values from a user archive 


See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 


Screenltem Object (Page 125) 


1.14.4.16 Q 
QualityCode Property 


Description 


Defines a standard for the quality of a tag value after being read. The quality code is provided 
as a 16-bit value for automatic evaluation. After a tag has been written, the value is invalid. 


SHORT (read only) 


Note 


A summary of possible Quality Codes is provided in the WinCC Information System under the 
heading "Communication" > "Diagnostics" or "Communication" > "Quality Codes". 


Example: 
The following example indicates the quality of the read value when no errors have occurred 
during the reading process: 


'VBS83 

Dim objTag 

Dim lngLastErr 

Set objTag = HMIRuntime.Tags ("Tagl") 
objTag.Read 


IngLastErr = objTag.LastError 
If 0 = IngLastErr Then 

sgBox objTag.QualityCode 
End If 
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See also 
LastError Property (Page 459) 
ErrorDescription Property (Page 411) 
Tag Object (Page 137) 
1.14.4.17 R 
Ra - Ri 
Radius Property 
Description 
Defines or returns the radius in pixels. 
See also 
Pie segment (Page 152) 
Circular arc (Page 151) 
Circle (Page 149) 
Round Button (Page 209) 
Screenltem Object (Page 125) 
RadiusHeight Property 
Description 
Defines or returns the vertical radius in pixels (0 to 5000). 
See also 


Ellipse segment (Page 147) 
Ellipse arc (Page 146) 

Ellipse (Page 144) 
Screenltem Object (Page 125) 
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RadiusWidth Property 


Description 
Defines or returns the horizontal radius in pixels (0 to 5000). 
See also 
Ellipse segment (Page 147) 
Ellipse arc (Page 146) 
Ellipse (Page 144) 
Screenltem Object (Page 125) 
RangeMax Property 
Description 
Defines the maximum absolute value for the value display. 
If the "WithLabels" property has the value -1 (yes), this value is displayed on the scale. 
See also 


WinCC Slider Control (Page 277) 
Screenltem Object (Page 125) 


RangeMin Property 


Description 


See also 


548 


Defines the minimum absolute value for the value display. 


If the "WithLabels" property has the value -1 (yes), this value is displayed on the scale. 


WinCC Slider Control (Page 277) 
Screenltem Object (Page 125) 
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Rectangular Property 


Description 


See also 


Defines or returns the side ratio of the rectangular background of the gauge. BOOLEAN write- 
read access. 


FALSE : The size of the gauge can be adjusted to any side ratio by dragging the marking points 
with the mouse. 


TRUE : The size of the gauge can only be adjusted by dragging the marking points with the 
mouse. The side ratio of the background always remains 1:1. 


Screenltem Object (Page 125) 
WinCC Gauge Control (Page 254) 


ReferenceRotationLeft Property 


Description 


See also 


Defines or returns the X-coordinate of the reference point about which the object should be 
rotated in Runtime. 

The value of the x coordinate is relative to the object width. Enter the value in percent starting 
from the left edge of the rectangle enclosing the object. 


Line (Page 154) 

Polyline (Page 158) 

Polygon (Page 156) 
Screenltem Object (Page 125) 


ReferenceRotationTop Property 


Description 


Defines or returns the Y-coordinate of the reference point about which the object should be 
rotated in Runtime. 


The value of the Y-coordinate is relative to the object height. Enter the value in percent starting 
from the top edge of the rectangle enclosing the object. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 549 


VBS for Creating Procedures and Actions 


7.14 VBS Reference 


See also 
Screenltem Object (Page 125) 
Line (Page 154) 
Polyline (Page 158) 
Polygon (Page 156) 
RelayCurves Property 
Description 
TRUE, when the trends should be displayed staggered. BOOLEAN write-read access. 
See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
Relevant Property 
Description 
TRUE, when the object will be taken into account when forming the group display. BOOLEAN 
write-read access. 
See also 
Group Display (Page 194) 
Screenltem Object (Page 125) 
Replacement Property 
Description 
The "Index" property references a trend. Values, whose start value is unknown on activating 
Runtime or for which a substitute value is used, have an unstable status. "Replacement" 
defines whether such values should be identified by the color defined in "ReplacementColor". 
BOOLEAN write-read access. 
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See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


ReplacementColor Property 


Description 
The "Index" property references a trend. Values, whose start value is unknown on activating 
Runtime or for which a substitute value is used, have an unstable status. "ReplacementColor" 
defines the color used to identify this value. The color is defined as an RGB value. Whether 
the information is evaluated is dependent on the value of the "Replacement" property. 

See also 


WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


RestrictedCursorMovement property 


Limited cursor movement (RestrictedCursorMovement) 


The "Limited cursor movement" attribute specifies whether the cursor is fixed on the left-hand 
side in the I/O field. This corresponds to the default setting when opening the I/O field. As a 
result, negative values are always displayed correctly You enter the values with decimal places 
regardless of the cursor position. You no longer have any possibility to change the position 
during the entry. The decimal place shown in the I/O field is hidden during the entry of a decimal 


place. 
Yes The cursor movement is restricted in the I/O field. The cursor is fixed on the left-hand side. 
No The cursor movement is not restricted in the I/O field. 


The "Limited cursor movement" attribute can be made dynamic with the 
"RestrictedCursorMovement" name. 


RightComma Property 


Description 


Defines or returns the number of decimal places (0 to 20). 
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See also 
Bar (Page 174) 
Screenltem Object (Page 125) 

Ro - Ru 

Rotation property 
Rotation (Rotation) 
Specifies anticlockwise rotation around the icon center. 
The following settings are available: 

Value Comments 

0 The icon is not rotated. 

90 The icon is rotated by 90 degrees. 

180 The icon is rotated by 180 degrees. 

270 The icon is rotated by 270 degrees. 


The attribute can be assigned dynamic properties by means of the name Rotation. The data 
type is LONG. 


RotationAngle Property 


Description 


552 


Standard objects 
Defines or returns the rotation angle in degrees. 


In Runtime, the object (starting from the configured starting position) is displayed rotated 
clockwise around the reference point by the specified value. The changed orientation of the 
object is only visible in Runtime. 


The coordinates of the reference point are defined with the "Rotation Reference X" and 
"Rotation Reference Y" attributes. 

T-piece 

Defines or returns the orientation of a T-piece in degrees. 


The attribute can assume one of four values. If you enter another value, it is automatically 
converted to modulus 360 and rounded up or down to the closest permissible value. 


The orientation is produced by rotating the T-piece clockwise around the center point by the 
specified number of degrees. 


0 The standard position of the T-piece is the shape of the letter "T" 
90 = The"leg" of the "T" points towards the left 
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180 The"leg" of the "T" points upwards 
270 The"leg" of the "T" points to the right 


See also 
Line (Page 154) 
Polyline (Page 158) 
Polygon (Page 156) 
Screenltem Object (Page 125) 


RoundCornerHeight Property 


Description 


Defines or returns the corner radius. 
Enter the value as a percentage of half the height of the object. 


See also 
Rounded rectangle (Page 162) 


Screenltem Object (Page 125) 


RoundCornerWidth Property 


Description 
Defines or returns the corner radius. 
Enter the value as a percentage of half the width of the object. 
See also 
Screenltem Object (Page 125) 
RowNumber property 
RowNumber 


Specifies the row number of the Row object of a Table Control. 
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RowScrollbar property 


Row scroll bars - RowScrollbar 
Enables the display of row scroll bars. 


The following settings are available: 


Value Description Explanation 
0 No No row scroll bars. 
1 as required Row scroll bars are displayed if horizontal space requirements of the control are greater 


than the actually available display area. 


2 always Row scroll bars are always displayed. 


The attribute can be assigned dynamic properties by means of the name RowScrollbar. The 
data type is LONG. 


RowTitleAlign property 
Row label alignment - RowTitleAlign 


Specifies the type of row label alignment. 


The following settings are available: 


Value Description Explanation 

0 left The row headers are aligned left. 

1 centered The row headers are aligned to center. 
2 right The row headers are aligned right. 


The attribute can be assigned dynamic properties by means of the name RowTitleAlign. The 
data type is LONG. 


RowtTitles property 


Show row labels - RowTitles 


Enables the display of row labels. 


Value Explanation 
TRUE The row labels are displayed. 
FALSE The row labels are not displayed. 


The attribute can be assigned dynamic properties by means of the name RowTritles. The data 
type is BOOLEAN. 
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RTPersistence property 


Online configuration at the next picture change - RTPersistence 
Enables retention of the online configurations of the control after a picture change. 


The following settings are available: 


Value | Description Explanation 

0 Discard The current online configurations are discarded at the next picture change. 

1 Retain The current online configurations are retained at the next picture change. 

2 Reset All online configurations made are lost. The picture is set to the contents 
found in the configuration system. 


The attribute can be assigned dynamic properties by means of the name RTPersistence. The 
data type is LONG. 


RTPersistencePasswordLevel property 


Operator authorization for online configuration - RTPersistencePasswordLevel 


Displays the authorization for online configuration. You can edit the authorization using the 
selection button. Authorizations are configured in the "User Administrator" editor. 


The attribute can be assigned dynamic properties by means of the name 
RTPersistencePasswordLevel . The data type is LONG. 


RTPersistenceType property 
Online configuration - RTPersistenceType 


Defines how to retain online configurations of WinCC. 


The following settings are available: 


Value | Description Explanation 


0 Do not retain Online configurations are not retained. These are lost at 
the next picture change. 


1 Retain during runtime Online configurations are retained during runtime. These 
are lost on exiting. 


2 Retain permanently Online configurations are retained permanently. These 
are also available after restart. 


The attribute cannot be dynamized. 
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RulerFont Property 


Description 


This attribute defines the font of the table of the tag values, which is displayed by the key 
function "Display value at this position" / "Ruler". Write/Read access. 


RulerPrecisions Property 


Description 
Defines the number of decimal places to which a measured value should be displayed when 
it is determined using the "Display value at this position" function. 

See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 

RulerPrecisionX Property 

Description 
Defines the number of decimal places used by the "Display value at this position" to display 
the X-coordinate of a measured value. Whether the information is evaluated is dependent on 
the value of the "TimeAxisxX" attribute. 

See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 

RulerPrecisionY Property 

Description 
Defines the number of decimal places used by the "Display value at this position" to display 
the Y-coordinate of a measured value. 

See also 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
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Window - RulerType 
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Specifies window to be displayed during runtime. Depending on the window type, only certain 
blocks can be used as columns of the WinCC RulerControl. 


The following window types can be selected: 


Value 
0 


Description 


"Ruler" window 


Explanation 


The ruler window shows the coordinate values of the trends ona 
ruler or values of a selected row in the table. 


"Statistics area" window 


The statistics area window shows the values of the low and high 
limit of trends between two rulers, or displays the selected range 
in the table. 


"Statistics" window 


The statistics window shows the statistic evaluation of trends be- 
tween two rulers, or it displays the selected values in the table. 


The attribute can be assigned dynamic properties by means of the name RulerType. The data 
type is LONG. 


1.14.4.18 S) 


Sa-Sc 


SameSize Property 


Description 


TRUE, when all four buttons of a Group Display object have the same size. BOOLEAN write- 
read access. 


See also 


Group Display (Page 194) 


Screenltem Object (Page 125) 


SavedTrend Property 


Description 


Displays the name of the last saved trend that was exported in WinCC Online Trend Control 
using the Save Report button. Read only access. 
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ScaleColor Property 


Description 


Defines or returns the color of the scale. LONG write-read access. 
The "Scaling" property must be set to TRUE for the color to be displayed. 


See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
ScaleTicks Property 
Description 
Defines the number of segments into which the bar will be subdivided by large tick marks of 
the scale: 
0-100: Object can be divided into a maximum of 100 segments 
= 0: The optimum number of segments is set automatically. 
See also 


Bar (Page 174) 
Screenltem Object (Page 125) 


Scaling Property 


Description 
TRUE, when a scale should also be used to represent a value. BOOLEAN write-read access. 


See also 
Bar (Page 174) 
Screenltem Object (Page 125) 


ScalingType Property 
Description of Bar Scaling 


Defines or returns the type of bar scaling. Value range from 0 to 6. 


0 = linear 
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1 = logarithmic 
2 = negative logarithmic 


3 = automatic (linear) 


4 = tangent 
5 = square 
6 = cubic 


The "Scaling" property must be set to TRUE for the color to be displayed. 


Description of Online Trend Control 


See also 


Specifies or returns the type of scaling for a trend referenced by "Index". Value range from 0 
to 2. 


0 = linear 
1 = logarithmic 


2 = negative logarithmic 


WinCC Online Trend Control (before WinCC V7) (Page 295) 
Bar (Page 174) 
Screenltem Object (Page 125) 


ScalingTypeX Property 


Description 


See also 


Defines the type of scaling of the X-axis of a trend referenced with "Index". Whether the 
information is evaluated is dependent on the value of the "TimeAxisX" attribute. 


0: Linear 
-1: Logarithmically. This setting prevents the display of negative values. 


-2: Logarithmically negated. This setting prevents the display of positive values. 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
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ScalingTypeY Property 


Description 

Defines the type of scaling of the Y-axis of a trend referenced with "Index". 

0: Linear 

-1: Logarithmically. This setting prevents the display of negative values. 

-2: Logarithmically negated. This setting prevents the display of positive values. 
See also 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


ScreenName Property 


Description 
Defines the picture to be displayed in the picture window in Runtime or returns the picture 
name. 
Note 
Always enter picture names without the extension "PDL" for reasons of compatibility with future 
versions. 

See also 


Picture Window (Page 179) 
Screenltem Object (Page 125) 


Screens Property 


Description 


Returns an object of type "Screens". 


Screens (read only) 
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Example: 
The following example accesses the picture "NewPDL1": 


"VBS84 
Dim objScreen 
Set objScreen = HMTRuntime.Screens ("NewPDL1") 


See also 
Screens Object (List) (Page 134) 
Screen Object (Page 131) 
HM Runtime Object (Page 118) 


Screenltems Property 


Description 
Returns an object of type "Screenltems". 
Screenltems (read only) 
Example: 
The following example issues the number of all the objects contained in the picture "NewPDL1": 
"VBS85 


Dim objScreen 
Set objScreen = HMTRuntime.Screens ("NewPDL1") 
Msgbox objScreen.ScreenItems.Count 


See also 
Screenltems Object (List) (Page 129) 
HM IRuntime Object (Page 118) 


ScrollBars Property 
Description 


TRUE, when the object is equipped with a scroll bar in Runtime. Read only access. 
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See also 


Picture Window (Page 179) 
Screenltem Object (Page 125) 


ScrollPositionX Property 


Description 


See also 


Specifies the horizontal positioning of the scroll bar in a picture window with slider, or returns 
its value. 


The picture is displayed in the picture window by positioning the horizontal and vertical scroll 
bars. If you wish to display the picture as a cutout where the scroll bars are located at the left 
and upper edge of the picture, use the properties "OffsetLeft" and "OffsetTop" as the origin of 
this cutout. 


Screenltem Object (Page 125) 
OffsetTop Property (Page 516) 
OffsetLeft Property (Page 515) 
Picture Window (Page 179) 


ScrollPositionY Property 


Description 


See also 
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Specifies the vertical positioning of the scroll bar in a picture window with slider, or returns its 
value. 


The picture is displayed in the picture window by positioning the horizontal and vertical scroll 
bars. If you wish to display the picture as a cutout where the scroll bars are located at the left 
and upper edge of the picture, use the properties "OffsetLeft" and "OffsetTop" as the origin of 
this cutout. 


OffsetTop Property (Page 516) 
OffsetLeft Property (Page 515) 
Picture Window (Page 179) 

Screenltem Object (Page 125) 
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SecondNeedleHeight Property 


Description 


See also 


Defines or returns the length of the second hand for the analog clock. The specification of the 
length is entered as a percentage value in relation to half the length of the short side of the 
rectangular background. Write/Read access. 


Example: 

The shorter side of the rectangular background is 100 pixels long. 

The second hand length is 80. 

This results in a length of the second hand of (100 pixels / 2) * 0.8 = 40 pixels. 


Screenltem Object (Page 125) 
WinCC Digital/Analog Clock (Page 246) 


SecondNeedleWidth Property 


Description 


See also 


Defines or returns the width of the second hand for the analog clock. The width is specified as 
a percentage value related to double the length of the second hand. Write/Read access. 


Example: 

The length of the second hand is 40 pixels. 

The second hand width is 2. 

This results in a width of the second hand of 40 pixels * 2 * 0.02 = 2 pixels. 


WinCC Digital/Analog Clock (Page 246) 
Screenltem Object (Page 125) 


SelBGColor Property 


Description 


Defines or returns the background color of the selected entry in a text list object. LONG write- 
read access. 
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See also 
Text list (Page 196) 
Screenltem Object (Page 125) 


SelectArchiveName property 


SelectArchiveName 
Opens the dialog for selecting the user archive. 


Programmers can set this attribute to allow users to select a user archive by means of a button, 
for example. 


The attribute can be assigned dynamic properties by means of the name 
SelectArchiveName. The data type is BOOLEAN. 


SelectedCellColor property 


Background color of selected cell - SelectedCellColor 
Specifies the background color of a selected cell. The button opens the "Color selection" dialog. 


The attribute can be assigned dynamic properties by means of the name SelectedCellColor. 
The data type is LONG. 


SelectedCellForeColor property 


Font color of the selected cell - SelectedCellForeColor 
Specifies the font color of the selected cell. The button opens the "Color selection" dialog. 


The attribute can be assigned dynamic properties by means of the name 
SelectedCellForeColor. The data type is LONG. 


SelectedRowColor property 


Background color of the selected row - SelectedRowColor 


Specifies the background color of the selected line. The button opens the "Color selection" 
dialog. 


The attribute can be assigned dynamic properties by means of the name SelectedRowColor. 
The data type is LONG. 
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SelectedRowForeColor property 


Font color of the selected row - SelectedRowForeColor 
Specifies the font color of the selected row. The button opens the "Color selection" dialog. 


The attribute can be assigned dynamic properties by means of the name 
SelectedRowForeColor. The data type is LONG. 


SelectedTitleColor property 


Background selection color - SelectedTitleColor 


Specifies the background color of a selected table header. The button opens the "Color 
selection" dialog. 


The setting is only active in Runtime if the "Selection color" or "UseSelectedTitleColor" option 
is activated. 


The attribute can be assigned dynamic properties by means of the name SelectedTitleColor. 
The data type is LONG. 


SelectedTitleForeColor property 


Font selection color - SelectedTitleForeColor 


Specifies the font color of the table header selected. The button opens the "Color selection" 
dialog. 


The setting is only active in Runtime if the "Selection color" or "UseSelectedTitleColor" option 
is activated. 


The attribute can be assigned dynamic properties by means of the name 
SelectedTitleForeColor. The data type is LONG. 


SelectedTrend Property 


Description 
This property brings a trend to the foreground via its name. Write/Read access. 


SelectionColoring property 


Selection colors for - SelectionColoring 


Enables the use of selection colors for cells or rows. 
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The following settings are available: 


Value Description Explanation 

0 None No selection colors for cells and rows. 
1 Cell Selection color for cell. 

2 Row Selection color for row. 

3 Cell and row Selection colors for cell and row. 


The attribute can be assigned dynamic properties by means of the name SelectionColoring. 
The data type is LONG. 


SelectionMode Property 


Description 


Defines whether and how a message line can be selected. 


e 0-NoSelection: Prevents the selection of amessage. Acknowledgement affects the oldest 
pending message. 


e 1- Cell: Enables the selection of fields in the message line. Acknowledgement affects the 
selected message. 


e 2- Line: Enables the selection of a message line. Acknowledgement affects the selected 


message. 


See also 


WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 


SelectionRect property 


Selection border- SelectionRect 


Enables the use of a selection border for selected cells or rows. 


The following settings are available: 


Value Description Explanation 

0 None No selection border is drawn for selected cells or rows. 
1 Cell A selection border is drawn for the selected cell. 

2 Row A selection border is drawn for the selected row. 


The attribute can be assigned dynamic properties by means of the name SelectionRect. The 
data type is LONG. 


566 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


VBS for Creating Procedures and Actions 
7.14 VBS Reference 


SelectionRectColor property (before WinCC V7) 


Description 


Specifies the color of the rectangle in the message window if SelectionType equals "1". 


See also 
WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 


SelectionRectColor property 


Color of the selection border - SelectionRectColor 
Specifies the color of the selection border. The button opens the "Color selection" dialog. 


The attribute can be assigned dynamic properties by means of the name SelectionRectColor. 
The data type is LONG. 


SelectionRectWidth property (before WinCC V7) 


Description 


Specifies the line weight of the rectangle in the message window if SelectionType equals "1". 


See also 
WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 


SelectionRectWidth property 


Line weight of the selection border - SelectionRectWidth 
Defines the line weight of the selection border in pixels. 


The attribute can be assigned dynamic properties by means of the name SelectionRectWidth. 
The data type is LONG. 
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SelectionType property (before WinCC V7) 


Description 
Specifies if the selected message in the message window should be optically emphasized by 
color change or rectangle. 
e 0- Color Change: selected message is optically emphasized by color change 
e 1 - Rectangle: selected message is optically emphasized by a rectangle 
See also 
WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 
SelectionType property 


Selectable rows - SelectionType 


Defines the number of lines you can select. The following settings are available: 


Description Explanation 
0 None No row selection. 
1 Single selection One row can be selected. 
2 Multiple selection Multiple rows can be selected. 


The attribute can be assigned dynamic properties by means of the name SelectionType. The 
data type is LONG. 


Sellndex property 


Description 
Defines and returns the index of which the associated text is highlighted in the combobox or 
list box. 
The maximum value is the number of lines (NumberLines) of the object. 

SelText property 

Description 


Shows the text defined with the "Selected field" (Sellndex) attribute which is highlighted in the 
combobox or list box. 
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SelTextColor Property 


Description 


Defines or returns the color of the text of the selected entry in the text list object. LONG write- 
read access. 


See also 
Text list (Page 196) 
Screenltem Object (Page 125) 

ServerData Property 

Description 
The attribute can only be modified using the "Properties of WinCC Online Trend Control" dialog. 
Read only access. 

See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 

ServerDataX 

ServerDataX 


Accesses the configured data connection for the X axis with WinCC FunctionTrendControl. 


The attribute can be assigned dynamic properties by means of the name ServerDataX. The 
data type is LONG. 


Example: Editing the start ID 


You may use the ServerDataX attribute to edit the start ID of the X axis. 


Prerequisite is that you have an existing trend and trend view, configured X and Y axes, as 
well as a data connection to the user archive. 


In the following example you employ the GetTrend method to set a reference to the object in 
step one, and then to the trend used in step two. Determine the data connection settings in 
the third step. Set the start ID to 4 in step 4. The number (3) represents the listing type "user 
archive" for data transfer. Change the modified data connection settings in step five: 
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ServerDataY 


ServerDataY 


Sub OnCklick(ByVal Item) 


1. Step: 
Dim fx ctrl 
Set fx ctrl ScreenItems.Item("Controll") 


2. Step: 
Dim fx trend 
Set fx trend = fx ctrl.Getrend("myTrendi") 


3. Step: 
Dim vServerDataX, vServerDataY 
vServerDataxX = fx trend.ServerDataXx 
vServerDataY = fx trend.ServerDataY 
4. Step: 


Dim startId 
startId = CLng(4) 


vServerDatax (3) = startid 
vServerDataY (3) = startId 
5. Step: 
fx trend.ServerDataX = ServerDataXx 
fx _trend.ServerDataY = ServerDataY 
End Sub 


Accesses the configured data connection for the Y axis with WinCC FunctionTrendControl. 


The attribute can be assigned dynamic properties by means of the name ServerDataY. The 
data type is LONG. 


Example: Editing the start ID 
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You may use the ServerDataY attribute to edit the start ID of the Y axis. 


Prerequisite is that you have an existing trend and trend view, configured X and Y axes, as 
well as a data connection to the user archive. 


In the following example you employ the GetTrend method to set a reference to the object and 
then to the trend used. Determine the data connection settings in the third step. Set the start 
ID to 4 in step 4. The number (3) represents the listing type "user archive" for data transfer. 
Change the modified data connection settings in step five: 


Sub OnCklick(ByVal Item) 


1. Step: 
Dim fx ctrlSet fx ctrl ScreenItems.Item("Controll1") 


2. Step: 
Dim fx trendSet fx trend = f£x ctrl.Getrend("myTrendli") 
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3. Step: 
Dim vServerDataxX, vServerDataYvServerDataX = 
fx_trend.ServerDataXvServerDataY = fx _trend.ServerDataY 
4. Step: 
Dim startIdstartId = CLng(4)vServerDataX(3) = 
startIdvServerDataY(3) = startId 
5. Step: 
fx trend.ServerDataX = ServerDataxfx trend.ServerDataY = 
ServerDataY 
End Sub 


ServerNames property 


Server selection - ServerNames 


Defines from which servers within a distributed system the message window obtains the 
display data. 


The attribute can be assigned dynamic properties by means of the name ServerNames. The 
data type is STRING. 


ServerNames property (before WinCC V7) 


Description 
Defines the server in a distributed system to which the data in the message window should 
relate. Servers are specified as follows: NameServer1;NameServer2;NameServer3. Write/ 
Read access. 

See also 
WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 

ServerPrefix Property 

Description 


Defines the server containing the picture to be displayed in the picture window in Runtime or 
returns the server name. 

Enter the server name followed by two colons: "<Servername>::". No check is made as to 
whether the server actually exists. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 571 


VBS for Creating Procedures and Actions 
7.14 VBS Reference 


See also 
Picture Window (Page 179) 


Screenltem Object (Page 125) 
Sh - Sk 
ShareSpaceWithSourceControl property 


ShareSpaceWithSourceControl 


Defines whether the size of the source control in the picture window is adapted so that the 
WinCC RulerControl is also displayed in a small picture window. 


Value Explanation 
TRUE The source control in the picture window is adapted. 
FALSE The source control in the picture window is not adapted. 


The attribute can be assigned dynamic properties by means of the name 
ShareSpaceWithSourceControl. The data type is BOOLEAN. 


ShowBar Property 


Description 
TRUE, when the bar should be displayed. BOOLEAN write-read access. 


See also 
WinCC Slider Control (Page 277) 


Screenltem Object (Page 125) 


ShowBarlcon property 


ShowBarlcon 
Enables the display of an icon below the value axes. The symbol indicates the diagram 
currently displayed in the foreground. 
The attribute can be assigned dynamic properties using the name ShowBarlcon. The data 
type is BOOLEAN. 
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ShowDanger Property 


Description 


Controls the display of the "danger zone" on the instrument scale. BOOLEAN write-read 
access. 


TRUE : The area is identified by the color defined in "DangerColor". 


FALSE : The color identification of the area is switched off. 


See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 
ShowDecimalPoint Property 
Description 
TRUE, when the labeling of the scale section should be with decimal numbers (decimal point 
and one decimal place). 
FALSE, when the labeling of the scale section should be with whole numbers. 
BOOLEAN write-read access. 
See also 


WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 


ShowMilliseconds property 


ShowMilliseconds 
Specifies whether milliseconds are displayed in the diagnostic buffer view. 


The attribute can be assigned dynamic properties using the name ShowMilliseconds. The data 
type is BOOLEAN. 


ShowNormal Property 


Description 


Controls the display of the "normal zone" on the instrument scale. BOOLEAN write-read 
access. 
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TRUE : The area is identified by the color defined for normal color. 


FALSE : The color identification of the area is switched off. 


See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 
ShowPeak Property 
Description 
Defines the display of a slave pointer to display the maximum value. BOOLEAN write-read 
access. 
TRUE : The slave pointer is displayed. 
FALSE : The slave pointer is hidden. 
See also 


WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 


ShowPosition Property 


Description 

TRUE, when the slider position is to be displayed. BOOLEAN write-read access. 
See also 

WinCC Slider Control (Page 277) 

Screenltem Object (Page 125) 
ShowRuler property 


Show ruler - ShowRuler 
Enables the display of a ruler for scanning the coordinate points on picture calls. 


Value Explanation 
TRUE Enables the display of a ruler for scanning the coordinate points. 
FALSE Disables the display of a ruler for scanning the coordinate points. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
574 System Manual, 02/2016, ASE37536061-AA 


VBS for Creating Procedures and Actions 
7.14 VBS Reference 


The attribute can be assigned dynamic properties by means of the name ShowRuler. The data 
type is BOOLEAN. 


ShowRulerlmmediately Property 


Description 
TRUE, when the ruler for determining the coordinate values should be displayed when opening 
a picture. BOOLEAN write-read access. 

See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 

ShowRulerlnAxis property 

ShowRulerInAxis 
Enables the display of rulers in the time axis. 

Value Explanation 

TRUE Enables the display of rulers in the time axes. 

FALSE Disables the display of rulers in the time axes. 


The attribute can be assigned dynamic properties by means of the name ShowRulerInAxis. 
The data type is BOOLEAN. 


ShowScrollbars property 
Scroll bars - ShowScrollbars 


Enables the display of scroll bars. 


The following settings are available: 


Value Description Explanation 

0 No The display of scroll bars is disabled. 

1 as required Scroll bars are displayed if space requirements of the control are greater than the actual 
display area. 

2 always The scroll bars are always displayed. 


The attribute can be assigned dynamic properties by means of the name ShowScrollbars. The 
data type is LONG. 
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ShowSlider property 


ShowSlider 


Specifies if a time slider is displayed in the control. 


The attribute can be assigned dynamic properties by means of the name ShowSlider. The data 
type is BOOLEAN. 


ShowSortButton property 


Use sorting button - ShowSortButton 


Enables the display of a sorting button above the vertical scroll bar. Click this sorting button 
to sort the selected column based on the configured sorting criteria. The sorting button is not 
displayed if the table does not contain a vertical scroll bar. 


Value Explanation 
TRUE Enables sorting of a selected column by means of sorting button. 
FALSE The sorting button is not displayed. 


The attribute can be assigned dynamic properties by means of the name ShowSortButton . 
The data type is BOOLEAN. 


ShowSortlcon property 


Show sorting icon - ShowSortlcon 


Enables the display of the sorting icon. 


Value Explanation 

TRUE Enables the display of the sorting icon. 

FALSE Disables the display of the sorting icon. 
The attribute can be assigned dynamic properties by means of the name ShowSortlcon. The 
data type is BOOLEAN. 

ShowSortIndex property 


Show sorting index - ShowSortIndex 


Enables the display of a sorting icon. 


Value Explanation 
TRUE Enables the display of a sorting index. 
FALSE Disables the display of a sorting index. 


576 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


VBS for Creating Procedures and Actions 
7.14 VBS Reference 


The attribute can be assigned dynamic properties by means of the name ShowSortIndex. The 
data type is BOOLEAN. 


ShowSpanNames Property 


Description 


TRUE, if a section name is also to be displayed in the Value column of Trend Control apart 
from the measured value and the status display "i" and "u". BOOLEAN write-read access. 


ShowStatisticRuler property 


ShowStatisticRuler 
Enables the display of rulers in the statistics field on picture calls. 
Value Explanation 
TRUE Enables the display of rulers in the statistics field. 
FALSE Disables the display of rulers in the statistics field. 


The attribute can be assigned dynamic properties by means of the name ShowStatisticRuler. 
The data type is BOOLEAN. 


ShowThumb Property 


Description 

TRUE, when the slider is to be displayed. BOOLEAN write-read access. 
See also 

WinCC Slider Control (Page 277) 

Screenltem Object (Page 125) 
ShowTitle property 


Window title - ShowTitle 


Defines representation the Control window header. 


Value Designation Explanation 

0 No No window title. 

1 Normal The window title consists of a WinCC icon and text. The text is entered in the "Text" field. 
2 Narrow The window title consists only of text. The text is entered in the "Text" field. 
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The attribute can be assigned dynamic properties by means of the name ShowTitle. The data 


type is LONG. 
ShowToolbar property 
ShowToolbar 
Specifies if a toolbar is displayed in the control. 
The attribute can be assigned dynamic properties by means of the name ShowToolbar. The 
data type is BOOLEAN. 
ShowTrendlcon property 


ShowTrendlcon 


Enables the display of an icon below the value axes. The icon indicates the trend currently 
displayed in the foreground. 


The attribute can be assigned dynamic properties by means of the name ShowTrendlcon. The 
data type is BOOLEAN. 


ShowValuesExponentialX Property 


Description 
TRUE, when the X-coordinate of a measured value determined via the "Display value at this 
position" function is displayed in exponential notation by a trend referenced via "Index". 
Whether the information is evaluated is dependent on the value of the "TimeAxisX" property. 
BOOLEAN write-read access. 

See also 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


ShowValuesExponentialY Property 


Description 


TRUE, when the Y-coordinate of a measured value determined via the "Display value at this 
position" function is displayed in exponential notation by a trend referenced via "Index". 
BOOLEAN write-read access. 
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WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


ShowWarning Property 


Description 
Controls the display of the "warning zone" on the instrument scale. BOOLEAN write-read 
access. 
TRUE : The area is identified by the color defined by the warning color attribute. 
FALSE : The color identification of the area is switched off. 
See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 
SignificantMask Property 
Description 
Is required in Runtime to display the active message class with the highest priority. 
The value of the SignificantMask property represents an internal system output value does not 
require any specific configuration by the user. Updating is initiated in Runtime by clicking on 
the object. 
See also 
Group Display (Page 194) 
Screenltem Object (Page 125) 
Sizeable property 
Sizeable 
Enables resizing of the control during runtime. 
Value Explanation 
TRUE The control can be resized during runtime. 


FALSE 


The control cannot be resized during runtime. 


The attribute can be assigned dynamic properties by means of the name Sizeable. The data 
type is BOOLEAN. 
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SkinName property 


Style - SkinName 
The control style can be defined in this selection field. 


The following settings are available: 


Value Designation Explanation 

Project setting The style corresponds to the project settings in WinCC Explorer. 
0 Simple "Classic" WinCC style 
1 Standard New WinCC V7 style 

Basic Process Control The style is reserved for internal use with Basic Process Control. 


The attribute can be assigned dynamic properties by means of the name SkinName. The data 
type is STRING. 


Sm - Sq 


SmallChange Property 


Description 
Defines how many steps the controller can be moved with one mouse click or returns the value. 


See also 
Slider (Page 212) 
Screenltem Object (Page 125) 


SmartTag property 


Description 

Returns an object of type "SmartTag". 
See also 

SmartTags Object (Page 136) 
SortOrder Property 
Description 


Defines the sort sequence of the message blocks in the message window. 
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SortSequence property 


Sorting order by mouse click - SortSequence 
Specifies how to change the sorting order by mouse click. 


The following sorting orders are available: 


Value Description Explanation 
0 Up/down/none You can toggle between ascending, descending and no sorting by means of mouse click. 
1 Up/down You can toggle between ascending and descending sorting order by means of mouse Click. 


The attribute can be assigned dynamic properties by means of the name SortSequence. The 
data type is LONG. 


SourceBeginTime Property 


Description 


In the case of online tags and archive tags ("ProviderType" = -1), it defines the starting time 
of the time range of a trend referenced via "Index" and to be displayed in the trend window. In 
the case of modification of "SourceBeginTime", impermissible combinations with other 
attributes for data connection could be created. Therefore, before modifying 
"SourceBeginTime", the immediate acceptance of the changes must be prevented using 
"FreezeProviderConnections". 


See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


SourceControl property 


Source - SourceControl 
Defines the control to be interconnected with WinCC RulerControl. 


The attribute can be assigned dynamic properties by means of the name SourceControl. The 
data type is STRING. 
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SouceControlType property 


Type - SourceControlType 
Defines the type of control that is interconnected with the WinCC RulerControl in the "Source" 


field. 

Designation Explanation 

0 None The RulerControl is not connected to any source. 

1 OnlineTrend The RulerControl is connected with an OnlineTrendControl. 
Control 

2 OnlineTable The RulerControl is connected with an OnlineTableControl. 
Control 

3 FunctionTrend The RulerControl is connected with a FunctionTrendControl. 
Control 


The attribute can be assigned dynamic properties by means of the name SourceControlType. 
The data type is LONG. 


SourceEndTime Property 


Description 


In the case of online tags and archive tags ("ProviderType" = -1), it defines the stopping time 
of the time range of a trend referenced via "Index" and to be displayed in the trend window. In 
the case of modification of "SourceEndTime", impermissible combinations with other attributes 
for data connection could be created. Therefore, before modifying "SourceEndTime", the 

immediate acceptance of the changes must be prevented using "FreezeProviderConnections". 


See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


SourceNumberOfUAValues Property 


Description 


For values from the user archives ("ProviderType" = -2) it defines the number of values which 
should be loaded from the user archive for a trend referenced via "Index". In the case of 
modification of "SourceNumberOfUAValues", impermissible combinations with other attributes 
for data connection could be created. Therefore, before modifying 
"SourceNumberOfUAValues", the immediate acceptance of the changes must be prevented 
using "FreezeProviderConnections". 
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See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


SourceNumberOfValues Property 


Description 


The "Index" property references a trend. In the case of online tags and archive tags 
("ProviderType" = -1), "SourceNumberOfValues" defines the number of values which should 
be displayed in the trend window. Whether the information is evaluated is dependent on the 
value of the "SourceTimeRange" property. 


In the case of modification of "SourceNumberOfValues", impermissible combinations with 
other attributes for data connection could be created. Therefore, before modifying 
"SourceNumberOfValues", the immediate acceptance of the changes must be prevented using 
"FreezeProviderConnections". 


See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


SourceTagNamexX Property 


Description 


The "Index" property references a trend. In the case of online tags and archive tags 
("ProviderType" = -1) "SourceTagNamex" defines the tag which should be displayed along 
the X-axis. In the case of modification of "SourceTagNamex", impermissible combinations with 
other attributes for data connection could be created. Therefore, before modifying 
"SourceTagNamex", the immediate acceptance of the changes must be prevented using 
"FreezeProviderConnections". 


See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
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SourceTagNameY Property 


Description 


See also 


The "Index" property references a trend. In the case of online tags and archive tags 
("ProviderType" = -1) "SourceTagNameyY" defines the tag which should be displayed along 
the X-axis. In the case of modification of "SourceTagNameyY", impermissible combinations with 
other attributes for data connection could be created. Therefore, before modifying 
"SourceTagNameyY", the immediate acceptance of the changes must be prevented using 
"FreezeProviderConnections". 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


SourceTagProviderDataX Property 


Description 


See also 


The attribute can only be modified using the "Properties of WinCC Function Trend Control" 
dialog. 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


SourceTagProviderDataY Property 


Description 


See also 
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The attribute can only be modified using the "Properties of WinCC Function Trend Control" 
dialog. 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
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SourceTimeRange Property 


Description 


The "Index" property references a trend. In the case of online tags and archive tags 
("ProviderType" = -1) "SourceTimeRange" defines how the time range to be displayed in the 
trend window is defined. In the case of modification of "SourceTimeRange", impermissible 
combinations with other attributes for data connection could be created. Therefore, before 
modifying "SourceTimeRange", the immediate acceptance of the changes must be prevented 
using "FreezeProviderConnections". 


0: The time range to be displayed is defined by the starting time (SourceBeginTime) and the 
number of value pairs (SourceNumberOfValues). 


-1: The time range to be displayed is defined by the starting time (SourceBeginTime) and 
stopping time (SourceEndTime). 


See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


SourceUAArchive Property 


Description 


The "Index" property references a trend. In the case of values from the user archives 
("ProviderType" = -2), "SourceUAArchive" defines the user archive from which the values 
should be loaded. In the case of modification of "SourceUAArchive", impermissible 
combinations with other attributes for data connection could be created. Therefore, before 
modifying "SourceUAArchive" the immediate acceptance of the changes must be prevented 
using "FreezeProviderConnections". 


See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


SourceUAArchiveStartID Property 


Description 


The "Index" property references a trend. In the case of values from the user archives 
("ProviderType" = -2), "SourceUAArchiveStartID" defines the data record from which the 
values should be loaded from the user archive. In the case of modification of 
"SourceUAArchiveStartID", impermissible combinations with other attributes for data 
connection could be created. Therefore, before modifying "SourceUAArchiveStartID", the 
immediate acceptance of the changes must be prevented using "FreezeProviderConnections". 
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See also 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


SourceUAColumnX Property 


Description 


See also 


The "Index" property references a trend. In the case of values from the user archives 
("ProviderType" = -2), "SourceUAColumnxX" defines the column in the user archive from which 
the values for the X-axis should be loaded. In the case of modification of "SourceUAColumnx", 
impermissible combinations with other attributes for data connection could be created. 
Therefore, before modifying "SourceUAColumnx", the immediate acceptance of the changes 
must be prevented using "FreezeProviderConnections". 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


SourceUAColumnY Property 


Description 


See also 


The "Index" property references a trend. In the case of values from the user archives 
("ProviderType" = -2), "SourceUAColumnY" defines the column in the user archive from which 
the values for the Y-axis should be loaded. In the case of modification of "SourceUAColumnyY", 
impermissible combinations with other attributes for data connection could be created. 
Therefore, before modifying "SourceUAColumnyY", the immediate acceptance of the changes 
must be prevented using "FreezeProviderConnections". 


WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


SplittedViewRatio property 


SplittedViewRatio 
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With a split display, this specifies the portion of the "Diagnostic overview" area is shown 
compared to the "Detail view" area. 


The attribute can be assigned dynamic properties using the name SplittedViewRatio. The data 
type is DOUBLE. 
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SquareExtent Property 


Description 


TRUE, when the size of the clock should be adjustable to any side ratio by dragging the marking 
points with the mouse. BOOLEAN write-read access. 


See also 
WinCC Digital/Analog Clock (Page 246) 
Screenltem Object (Page 125) 
St - Sy 
StartAngle Property 
Description 
Defines or returns the start of the object. The information is in counterclockwise direction in 
degrees, beginning at the 12:00 clock position. 
See also 
Pie segment (Page 152) 
Circular arc (Page 151) 
Ellipse segment (Page 147) 
Ellipse arc (Page 146) 
Screenltem Object (Page 125) 
State property 
Description 


Returns the status of a message. 


The following table shows the possible states of a message: 


State Alarm Log Status 

1 Came In 

2 Went Out 

5 Came in and comment 
6 Gone and comment 
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See also 
Alarms object (list) (Page 110) 
Statusbar Property 
Description 
TRUE, when the status line is to be displayed. BOOLEAN write-read access. 
See also 


WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 


StatusbarAlignment property 


Alignment - StatusbarAlignment 


Specifies the alignment of the status bar in the control. 


The following settings are available: 


Value Description Explanation 

0 Top The status bar is aligned to the top edge. 

1 Below The status bar is aligned to the bottom edge. 
2 Left The status bar is aligned to the left edge. 

3 Right The status bar is aligned to the right edge. 


The attribute can be assigned dynamic properties using the name StatusbarAlignment. The 
data type is LONG. 


StatusbarBackColor property 


Background color - StatusbarBackColor 
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Defines the background color of the status bar. The button opens the "Color selection" dialog 
to select the color. 


For the setting to become active, the "Display" or "StatusbarUseBackColor" option must be 
activated. 


The attribute can be assigned dynamic properties by means of the name 
StatusbarBackColor. The data type is LONG. 
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StatusbarElementAdd property 


New - StatusbarElementAdd 


Defines a new, user-defined status bar element. The name set by WinCC can be edited in the 
"Object name" field. 


The attribute can be assigned dynamic properties by means of the name 
StatusbarElementAdd . The data type is STRING. 


StatusbarElementAutoSize property 


Automatic - StatusbarElementAutoSize 


Enables autosizing of the width of a status bar element selected. 


Value Explanation 
TRUE The width of the selected element is set automatically. 
FALSE The width of the selected element is not set automatically. 


The attribute can be assigned dynamic properties by means of the name 
StatusbarElementAutoSize. The data type is BOOLEAN. 


StatusbarElementCount property 


StatusbarElementCount 
Defines the number of configurable status bar elements. 


The attribute can be assigned dynamic properties by means of the name 
StatusbarElementCount. The data type is LONG. 


StatusbarElementiconld property 
StatusbarElementiconld 


Default assignment of the ID number and icon of a status bar element. 


The attribute for custom status bar elements can be made assigned dynamic properties by 
measn of the name StatusbarElementliconld. The data type is LONG. 


StatusbarElementID property 
Object ID - StatusbarElementID 


Unique ID of the status bar element selected. WinCC assigns this read only ID number. 
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The attribute can be assigned dynamic properties by means of the name 
StatusbarElementID. The data type is LONG. 


StatusbarElementindex property 


StatusbarElementIndex 


References a status bar element. Using this attribute you can assign the values of other 
attributes to a specific status bar element. 


Values between 0 and "StatusbarElementCount" minus 1 are valid for 
"StatusbarElementIndex". Attribute "StatusbarElementCount" defines the number of 
configurable status bar elements. 


The "StatusbarElementindex" attribute can be assigned dynamic properties by means of 
attribute StatusbarElementindex. The data type is LONG. 


StatusbarElementName property 


Object name - StatusbarElementName 


Displays the object name of the status bar element selected. You can rename the objects of 
custom status bar elements. 


The "StatusbarElementName" attribute can be assigned dynamic properties by means of 
attribute StatusbarElementRename. The data type is STRING. 


StatusbarElementRemove property 


Remove - StatusbarElementRemove 


Removes the selected status bar element. You can only remove user-defined status bar 
element from the list. 


The attribute can be assigned dynamic properties by means of the name 
StatusbarElementRemove. The data type is STRING. 


StatusbarElementRename property 


StatusbarElementRename 


Renames a custom status bar element which is referenced by means of 
"StatusbarElementindex" attribute. 


The attribute for custom elements can be assigned dynamic properties by means of the name 
StatusbarElementRename. "StatusbarElementRename" also sets a dynamic attribute 
"StatusbarElementName". The data type is STRING. 
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StatusbarElementRepos property 


Up/Down - StatusbarElementRepos 


Changes the sorting order of button functions. "Up" and "Down" moves the selected status bar 
element up or down in the list. This moves the status bar element of the Control towards the 
front or towards the back in Runtime. 


The attribute can be assigned dynamic properties by means of the name 
StatusbarElementRepos . The data type is LONG. 


StatusbarElementText property 


StatusbarElementText 


Defines the text to be displayed for the status bar element. You can edit the 
"StatusbarElementText" attribute for custom elements. 


The attribute for custom elements can be assigned dynamic properties by means of the name 
StatusbarElementText. The data type is STRING. 


StatusbarElementTooltipText property 


StatusbarElementTooltipText 
Defines the tooltip text for the custom status bar element. 


The attribute can be assigned dynamic properties by means of the name 
StatusbarElementTooltipText. The data type is STRING. 


StatusbarElementvVisible property 


Status bar elements - StatusbarElementVisible 
Activate the elements in the list of status bar elements for their display in Runtime. 


Click a list entry to adapt the properties, or to change its position in the status bar of the Control 
by means of the "Up" and "Down" buttons. 


Value Explanation 
TRUE The status bar element is displayed. 
FALSE The status bar element is not displayed. 


The attribute can be assigned dynamic properties by means of the name 
StatusbarElementVisible. The data type is BOOLEAN. 
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StatusbarElementUserDefined property 


StatusbarElementUserDefined 
Indicates whether the project engineer has added the status bar element as a new custom 


element. 
Value Explanation 
TRUE The status bar element is user-defined. 
FALSE The status bar element is defined by the system. 


The attribute can be assigned dynamic properties by means of the name 
StatusbarElementUserDefined. The data type is BOOLEAN. 


StatusbarElementWidth property 


Width in pixels - StatusbarElementWidth 


Shows the width of the status bar element selected in pixels. You can define the width if the 
"Automatic" option is not activated. 


The attribute can be assigned dynamic properties by means of the name 
StatusbarElementWidth. The data type is LONG. 


StatusbarFontColor property 


Font color - StatusbarFontColor 
Defines the color of the text in the status bar. 


The attribute can be assigned dynamic properties by means of the name StatusbarFontColor. 
The data type is LONG. 


StatusbarPanes Property 


Description 
Defines the elements to be displayed in the status bar. Write/Read access. 


See also 
WinCC Alarm Control (before WinCC V7) (Page 286) 


Screenltem Object (Page 125) 
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StatusbarShowTooltips property 


Tooltips - StatusbarShowTooltips 


Enables the display of tooltips for the status bar elements in Runtime. 


Value Explanation 
TRUE Enables the display of tooltips. 
FALSE Disables the display of tooltips. 
The attribute can be assigned dynamic properties by means of the name 
StatusbarShowTooltips. The data type is BOOLEAN. 
Attribute "StatusbarElementTooltipText" defines the tooltip text. 
StatusbarText property 
StatusbarText 


Default text in the status bar. 


The attribute can be assigned dynamic properties by means of the name StatusbarText. The 
data type is STRING. 


StatusbarUseBackColor property 


Display background color - StatusbarUseBackColor 


Sets a background color for the status bar. 


Value Explanation 
TRUE Enables the display of the background color of the status bar. 
FALSE Disables the display of a background color for the status bar. 
The attribute can be assigned dynamic properties by means of the name 
StatusbarUseBackColor. The data type is BOOLEAN. 
StatusbarVisible property 


Show status bar - StatusbarVisible 


Enables the display of the status bar of a control. 


Value Explanation 
TRUE 


FALSE 


Enables the display of a status bar. 


Disables the display of a status bar. 
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The attribute can be assigned dynamic properties by means of the name StatusbarvVisible . 
The data type is BOOLEAN. 


StepSeconds property 
StepSeconds 


Specifies the interval for step forward or step backward in movies. 


The attribute can be assigned dynamic properties by means of the name StepSeconds. The 
data type is LONG. 


Stretch Property 


Description 
Defines whether the side ratio is retained or adjustable on changing the icon size. BOOLEAN 
write-read access. 
e FALSE : The side ratio is retained on changing the icon size. 
@ TRUE : The side ratio of the icon can be adjusted parallel to changing the icon size. 
See also 


HMI Symbol Library (Page 239) 
Screenltem Object (Page 125) 


SymbolAppearance property 


Foreground mode (SymbolAppearance) 
Specifies the appearance of the icon. 


The following settings are available: 


Value Description Comments 


0 Original The appearance of the icon corresponds to the multi-color representation in the 
selection of the "Icons" tab. 


1 Shadow "Black" lines are maintained as contour lines. Elements of the symbols in other 
colors are displayed as brightness grades of the current foreground color. 


2 Solid "Black" lines are maintained as contour lines. All icon elements of other colors are 
assigned the color value of the current foreground color. 


3 Outline Lines of the color "Black" are maintained as contour lines. All the elements of the 
symbol in other colors are assigned the color value of the current background color. 


The attribute can be assigned dynamic properties by means of the name SymbolAppearance. 
The data type is LONG. 
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1.14.4.19 T 
Ta -Tic 
TableColor property 


Row background color 1 - TableColor 
Defines the background color of the rows. The button opens the "Color selection" dialog. 


The attribute can be assigned dynamic properties by means of the name TableColor. The data 
type is LONG. 


TableColor2 property 


Row background color 2 - TableColor2 
Specifies the background color of "Row color 2". The button opens the "Color selection" dialog. 


The setting is only active in Runtime if the "Row color 2" or "UseTableColor2" option is 
activated. The background colors of "Row color 2" and "Row color 1" are used alternately in 
this case. 


The attribute can be assigned dynamic properties by means of the name TableColor2. The 
data type is LONG. 


TableFocusOnButtonCommand Property 


Description 
Defines whether the focus is set to the table of the control when a button in a script is clicked. 


TableForeColor property 
Row font color 1 - TableForeColor 


Specifies the font color of the rows. The button opens the "Color selection" dialog. 


The attribute can be assigned dynamic properties by means of the name TableForeColor. The 
data type is LONG. 


TableForeColor2 property 


Row font color 2 - TableForeColor2 
Specifies the font color of "Row color 2". The button opens the "Color selection" dialog. 
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The setting is only active in Runtime if the "Row color 2" or "UseTableColor2" option is 
activated. The font colors of "Row color 2" and "Row color 1" are used alternately in this case. 


The attribute can be assigned dynamic properties by means of the name TableForeColor2. 
The data type is LONG. 


TagName Property 


Description 


See also 


The "Index" property references a trend. "TagName" defines the tag linked to this trend. It is 
specified in the form "Archivname\Variablenname" to display tags in a process value archive 
or "TasgName" to display an internal or external tag which is not stored in an archive. 


WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 


TagPrefix Property 


Description 
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Defines or returns the tag prefix which is prefixed to all tags contained in the picture window 
object. In this way, a picture that is embedded in a picture window retains access to its own 
tags while another accesses other tags. 


Modification of the TagPrefix takes effect when a picture is reloaded. When a picture is 
changed, this occurs automatically; otherwise, the picture name must be reassigned. 


The tag prefix can be freely defined, but must match the name of the structure tags. 


Note 
Do not specify an additional tag prefix in the child picture window 


If a picture window is configured in a referenced picture of a picture window, the tag prefix of 
the parent picture window is applied to the child picture window of the tag prefix. You should 
not specify an additional tag prefix in the child picture window, because WinCC does not 
support bundled structure tags. The interpretation "Tag_prefix1.Tag_prefix2.Tag_name" 
cannot be used for dynamization. 


Note 


The TagPrefix property is not available for the controls. 
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See also 
Picture Window (Page 179) 
Screenltem Object (Page 125) 
Tags Property 
Description 
Returns an object of type "Tags". 
Tags (read only) 
Example: 
The following example accesses the tag "Tag1": 
'VBS86 


Dim objTag 
Set objTag = HMIRuntime.Tags ("Tagl") 


See also 
Tags Object (List) (Page 140) 
HM IRuntime Object (Page 118) 


TagProviderClsid Property 


Description 


The "Index" property references a trend. "TagProviderClsid" defines whether this trend should 
display an online tag or archived value. The data is only evaluated for online tags and archive 
tags ("ProviderType" = -1). 


{A3F69593-8AB0-11D2-A440-O0OAOC9DBB64E}: Online tag. 


{416A09D2-8B5A-11D2-8B81-006097A45D48}: Values are read from a process value archive 
or a user archive. 


See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
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Template Property 


Description 


See also 


Text Property 


Description 


598 


Returns the template for displaying the window content of the "Application Window" object. 
Read only access. 


The following templates are possible depending on the property value: 


Window Contents = Global Script 
"GSC diagnostics" 


The application window is supplied by applications of the Global Script. The results of the 
diagnosis system are displayed. 


"GSC Runtime" 
The application window is supplied by applications of the Global Script. The analysis results 
regarding characteristics in Runtime are displayed. 


Window Contents = Print Jobs 


"All Jobs": 
The application window is supplied by the logging system. The available reports are displayed 
as a list. 


"All Jobs - Context Menu": 

The application window is supplied by the logging system. The available reports are displayed 
as a list. The shortcut menu enables the selection of print options, display of a print preview 
as well as a printout of the log. 


"Job Detail View": 
The application window is supplied by the logging system. The available reports are displayed 
in a selection menu. Detailed information is displayed for the selected report. 


"Selected Jobs - Context Menu”: 

The application window is supplied by the logging system. The available reports are displayed 
as a list. This list only contains reports which you have activated the option "Mark for print job 
list" in the "Print Job Properties" dialog. The shortcut menu enables the selection of print 
options, display of a print preview as well as a printout of the log. 


Screenltem Object (Page 125) 
Application Window (Page 173) 


Defines or returns the labeling for an object. 
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See also 

Radio box (Page 207) 

Check box (Page 204) 

Button (Page 201) 

Static text (Page 165) 

Screenltem Object (Page 125) 
ThumbBackColor Property 
Description 

Defines the color of the slider. 
See also 

WinCC Slider Control (Page 277) 

Screenltem Object (Page 125) 
TicColor Property 
Description 

Defines the color of the scale tick marks. LONG write-read access. 
See also 

WinCC Gauge Control (Page 254) 

Screenltem Object (Page 125) 
TicFont Property 
Description 


Controls the display of the scale division labeling. Read only access. 
The following properties can be set: 

- Font 

- Font Style 

- Font Size 

- "Strikethrough" effect 


- "Underline" effect 
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See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 
TicOffset Property 
Description 
Defines the diameter of the imaginary circle on which the scale graduation is set. The value is 
related to the smaller value of the geometric properties Width and Height. 
The ends of the main tick marks of the scale graduation point outwards onto this circle. 
Value range from 0 to 1. 
0: The scale division is in the middle of the graduated scale disk. 
1: The diameter of the imaginary circle for the scale tick marks is the smaller value of the 
geometric properties Width and Height. 
See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 
TicTextColor Property 
Description 
Defines the color of the labeling of the scale tick marks. 
See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 
TicTextOffset Property 
Description 
Defines the diameter of the imaginary circle on which the labeling of the scale tick marks is 
set. The value is related to the smaller value of the geometric properties Width and Height. 
Value range from 0 to 1. 
0: The label is in the middle of the graduated scale disk. 
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1: The diameter of the imaginary circle for the label is the smaller value of the geometric 
properties Width and Height. As a result, part of the label can lie outside the object limits and 
is, thus, invisible. 


WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 


TicWidth Property 


Description 
Defines the length of the long tick marks for the scaling. The value is related to the half the 
smaller value of the geometric properties Width and Height. 
The length of the tick marks for fine scaling is 0.5*scale width. 
Value range from 0 to end of scale. 
0: No scale graduation is available. The division of the scale into ranges is not visible. 
Scaling distance: The scaling division ranges from the middle point of the graduated scale disk 
to the value defined by the scaling distance. 
See also 
Screenltem Object (Page 125) 
WinCC Gauge Control (Page 254) 
Ticks Property 
Description 
TRUE, when the numbered face is displayed. BOOLEAN write-read access. 
See also 
WinCC Digital/Analog Clock (Page 246) 
Screenltem Object (Page 125) 
TicksColor Property 
Description 


Defines or returns the color of the hour markings on the face of the analog clock. LONG write- 
read access. 
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See also 
WinCC Digital/Analog Clock (Page 246) 
Screenltem Object (Page 125) 
TickStyle Property 
Description 
This attribute defines the appearance of the scale. Value Range: 0 to 3. 
As a result of the automatic scaling, it is possible that, occasionally, two scale tick marks lie 
directly beside each other (apparently wide tick mark). This effect can be corrected by minimally 
lengthening or shortening the slider object. 
It is also possible to completely suppress display of the scaling ("WithAxes"). 
See also 


WinCC Slider Control (Page 277) 
Screenltem Object (Page 125) 


TimeAxis - TimeBase 


TimeAxis Property 


Description 
Defines whether a common time axis should be used for all trends in the trend window. 


See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 


TimeAxisActualize property 


Refresh - TimeAxisActualize 


Enables refreshing of the time axis selected. 


Explanation 


TRUE Enables updates of the trend window which is assigned to the time axis. 


FALSE Disables updates of the trend window which is assigned to the time axis. This setting can 
be useful when comparing a logged trend with a current trend. 
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The attribute can be assigned dynamic properties by means of the name TimeAxisActualize. 
The data type is BOOLEAN. 


TimeAxisAdd property 


New - TimeAxisAdd 
Creates a new time axis. 


The attribute can be assigned dynamic properties by means of the name TimeAxisAdd. The 
data type is STRING. 


TimeAxisAlign property 
Alignment - TimeAxisAlign 


Specifies the mode of alignment of a selected time axis. 


The following settings are available: 


Value Description Explanation 
0 Bottom The selected time axis is displayed below the trend or diagram. 
1 Top The selected time axis is displayed above the trend or diagram. 


The attribute can be assigned dynamic properties by means of the name TimeAxisAlign. The 
data type is LONG. 


TimeAxisBarWindow property 


Diagram window - TimeAxisBarWindow 


Specifies the diagram window in which the selected time axis will be used. You can specify 
the available diagram window in the "Diagram window" tab or using "BarWindowAdd". 


The attribute can be assigned dynamic properties using the name TimeAxisBarWindow. The 
data type is STRING. 


TimeAxisBeginTime property 


Start time - TimeAxisBeginTime 
Defines the start of the time range for a selected time axis. 


The attribute can be assigned dynamic properties by means of the name 
TimeAxisBeginTime. The data type is Date. 


Use the "yyyy-mm-dd hh:mm:ss" format when setting a dynamic time range. 
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TimeAxisColor property 


Time axis color - TimeAxisColor 


Specifies the color of the time axis. The button opens the "Color selection" dialog to select the 
color. 


The setting is only active if the "Use trend color" or "Use diagram color" option is disabled or 
if "ValueAxisInTrendColor" is "FALSE". 


The attribute can be assigned dynamic properties by means of the name TimeAxisColor. The 
data type is LONG. 


TimeAxisCount property 


TimeAxisCount 


Defines the number of time axes configured. 


The attribute can be assigned dynamic properties by means of the name TimeAxisCount. The 
data type is LONG. 


TimeAxisDateFormat property 


Date format - TimeAxisDateFormat 


Defines the date format for visualizing a selected time axis. 


The following date formats are available: 


Value Explanation 

Automatic The date format is set automatically. 

dd.MM.yy Day.Month.Year, e.g. 24.12.07. 

dd.MM.yyyy Day.Month.Year, e.g. 24.12.2007. 

dd/MM/yy Day/Month/Year, e.g. 24/12/07. 

dd/MM/yyyy Day/Month/Year, e.g. 24/12/2007. 
The attribute can be assigned dynamic properties by means of the name 
TimeAxisDateFormat. The data type is STRING. 

TimeAxisEndTime property 


End time - TimeAxisEndTime 


604 


Defines the end of the time range of a selected time axis. 


The attribute can be assigned dynamic properties by means of the name TimeAxisEndTime. 
The data type is Date. 


Use the "yyyy-mm-dd hh:mm:ss" format when setting a dynamic time range. 
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TimeAxisFormat Property 


Description 


Defines the format of the information along the time axis. 

@ 0: The information is provided in hh:mm 

e@ -1: The information is provided in hh:mm:ss 

@ -2: The information is provided in hh:mm:ss.ms 

e -3: The information is provided in hh:mm (full hours) 

e@ -4: The information is provided in hh:mm:ss (full minutes) 


e -5: The information is provided in hh:mm:ss.ms (full seconds) 


See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 

TimeAxisInBarColor property 


In diagram color - TimeAxisInBarColor 


Specifies whether the selected time axis will be displayed in the diagram color. If there is more 
than one diagram in the diagram window, the color of the first diagram will be used. You specify 
the order of the diagrams on the "Diagrams" tab. 


Value Explanation 
TRUE The selected time axis is displayed in the diagram color. The setting in the "Color" or "TimeAxisColor" field is 
disabled. 
FALSE The selected time axis is displayed in the color set in the "Color" or "TimeAxisColor" field. 
The attribute can be assigned dynamic properties using the name TimeAxisInBarColor. The 
data type is BOOLEAN. 
TimeAxisIndex property 


TimeAxisIndex 


References a configured time axis. Using this attribute you can assign the values of other 
attributes to a specific time axis. 


Values between 0 and "TimeAxisCount" minus 1 are valid for "TimeAxisIndex". Attribute 
“TimeAxisCount" defines the number of trends configured. 


The "TimeAxisIndex" attribute can be assigned dynamic properties by means of attribute 
TimeAxisRepos. The data type is LONG. 
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TimeAxisInTrendColor property 


Use trend color - TrendAxisInTrendColor 


Sets a trend color for displaying the time axis selected. The color of the first trend is activated 
if several trends are displayed in the trend window. Define the order of trends on the "Trends" 
tab. 


Explanation 


TRUE The trend color is used to display the time axis selected. The setting in the "Color" or "Time- 
AxisColor" field is disabled. 


FALSE The time axis selected is displayed in the color set in the "Color" or "TimeAxisColor" field. 


The attribute can be assigned dynamic properties by means of the name 
TimeAxisInTrendColor. The data type is BOOLEAN. 


TimeAxisLabel property 


Label - TimeAxisLabel 
Defines the label text for a time axis. 


The attribute can be assigned dynamic properties by means of the name TimeAxisLabel. The 
data type is STRING. 


TimeAxisMeasurePoints property 


Number of measurement points - TimeAxisMeasurePoints 
Defines the number of measurement points to be displayed at the time axis selected. 


The attribute can be assigned dynamic properties by means of the name 
TimeAxisMeasurePoints. The data type is LONG. 


TimeAxisName property 


Object name - TimeAxisName 
Specifies the name of a selected time axis. 


The "TimeAxisName" attribute can be assigned dynamic properties by means of attribute 
TimeAxisRename. The data type is STRING. 
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TimeAxisRangeType property 


Time range setting - TimeAxisRangeType 


Specifies the time range for the time axis selected. 


Value | Description Explanation 

0 Time range Defines the start time and the time range for the time axis. 

1 Start to end time Defines the start and end time for the time axis. 

2 Number of measurement Defines the start time and the number of measurement points 
points for the time axis. 


The attribute can be assigned dynamic properties by means of the name 
TimeAxisRangeType. The data type is LONG. 


TimeAxisRemove property 


Remove - TimeAxisRemove 
Removes the selected time axis from the list. 


The attribute can be assigned dynamic properties by means of the name TimeAxisRemove. 
The data type is STRING. 


TimeAxisRename property 


TimeAxisRename 
Renames a time axis which is referenced by means of "TimeAxisIndex" attribute. 


The attribute can be assigned dynamic properties by means of the name TimeAxisRename. 
"TimeAxisRename" also sets a dynamic attribute "TimeAxisName". The data type is STRING. 


TimeAxisRepos property 


Up/Down - TimeAxisRepos 


Changes the order of the time axes. "Up" and "Down" move the selected time axis up or down 
in the list. 


The list order determines the time axis position in the trend window or diagram window in 
runtime. If the orientation is the same and the time axis is further above, the time axis is shown 
at a more remote position of the curve or diagram. 


The attribute can be assigned dynamic properties by means of the name TimeAxisRepos. The 
data type is LONG. 
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TimeAxisShowDate property 


Show date - TimeAxisShowDate 


Enables the display of the date and time at the time axis selected. 


Value Explanation 
TRUE Date and time are displayed. The date format is defined in the "Date format" field. 
FALSE The date is not displayed. Only the time is displayed. 
The attribute can be assigned dynamic properties by means of the name TimeAxisShowDate. 
The data type is BOOLEAN. 
TimeAxis TimeFormat property 


Time format - TimeAxisTimeFormat 


Defines the time format for visualizing a selected time axis. 


The following time formats are available: 


Value 
Automatic 


Explanation 


The time format is set automatically. 


hh:mm:ss.ms 


Hours:Minutes:Seconds, e.g. 15:35:44.240. 


hh:mm:ss tt 


Hours:Minutes:Seconds AM/PM, e.g. 03:35:44 PM. 


hh:mm:ss.ms tt 


Hours:Minutes:Seconds.Milliseconds AM/PM, e.g. 03:35:44.240 PM. 


The attribute can be assigned dynamic properties by means of the name 
TimeAxis TimeFormat. The data type is STRING. 


TimeAxis TimeRangeBase property 


Time range - TimeAxis TimeRangeBase 


Defines the time unit for calculating the time range. 


The following time units are available: 


Value Description 
500 500 ms 
1000 1 second 
60000 1 minute 
3600000 1 hour 
86400000 1 day 
The attribute can be assigned dynamic properties by means of the name 
TimeAxisTimeRangeBase. The data type is LONG. 
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TimeAxis TimeRangeFactor property 


Time range - TimeAxisTimeRangeFactor 
Defines the factor for calculating the time range. Only integer factors are valid. 


The attribute can be assigned dynamic properties by means of the name 
TimeAxisTimeRangeFactor. The data type is SHORT. 


TimeAxis TrendWindow property 


Trend window - TimeAxisTrendWindow 


Specifies the trend window for displaying the time axis selected. Define the available trend 
windows in the "Trend window" or "TrendWindowAda" tab. 


The attribute can be assigned dynamic properties by means of the name 
TimeAxis TrendWindow. The data type is STRING. 


TlmeAxisVisible property 


Time axis - TimeAxisVisible 


The list shows all time axes you created. Click a time axis entry in the list to adapt the properties 
and to assign a trend window or diagram window to the time axis. 


Select the time axes in the list that you want to display in the trend windows or diagram 
windows. 


Defines whether the selected time axis is displayed. 


Value Explanation 
TRUE The time axis is displayed. 
FALSE The time axis is not displayed. 


The attribute can be assigned dynamic properties by means of the name TimeAxisVisible. The 
data type is BOOLEAN. 


TimeAxisX Property 


Description 


TRUE, when a common axis should be used for all trends in the trend window. BOOLEAN 
write-read access. 
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See also 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 

TimeBase property 


Time base - TimeBase 
This selection field is used to define the time base for the time stamp in the control. 


Designation 
0 Local time zone 
1 Coordinated Universal Time (UTC) 
2 Project setting 


The attribute can be assigned dynamic properties by means of the name TimeBase. The data 
type is LONG. 


TimeColumn 


TimeColumnActualize property 


TimeColumnActualize 
Enables the update of values in the selected column. 


Value Explanation 
TRUE The time column is updated. 
FALSE The time column is not updated. This setting can be useful when comparing tables. 


The attribute can be assigned dynamic properties by means of the name 
TimeColumnActualize. The data type is BOOLEAN. 


TimeColumnAdd property 


New - TimeColumnAdd 
Creates a new time column. 


The attribute can be assigned dynamic properties by means of the name TimeColumnAdd. 
The data type is STRING. 
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Alignment - TimeColumnAlign 


Defines the mode of alignment of the time column selected. 


The following settings are available: 


7.14 VBS Reference 


Value Description Explanation 

0 left The time column selected is displayed on the left. 
1 Centered The time column selected is aligned to center. 

2 right The time column selected is displayed on the right. 


The attribute can be assigned dynamic properties by means of the name TimeColumnAlign. 
The data type is LONG. 


TimeColumnAlignment Property 


Description 


See also 


The "Index" property references a pair of columns. "TimeColumnAlignment" defines the 
alignment of the time column for this column pair. 


@ 0: Time values are entered aligned left. 
e 1: Time values are entered centered. 


e 2: Time values are entered aligned right. 


WinCC Online Table Control (before WinCC V7) (Page 292) 
Screenltem Object (Page 125) 


TimeColumnBackColor property 


Background color - TimeColumnBackColor 


Specifies the background color of the time column selected. Use the button to open the "Color 
selection" dialog. 


The setting is useful if: 


e The "Use value column colors" option is not activated or 
"TimeColumnUseValueColumnColors" is "FALSE". 


@ The "Background color" option is activated or "UseColumnBackColor" is "TRUE in the "Use 
column color" field of the "General" tab". 


The attribute can be assigned dynamic properties by means of the name 
TimeColumnBackColor. The data type is LONG. 
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TimeColumnBeginTime property 


Start time - TimeColumnBeginTime 
Defines the start of the time range for a selected time column. 


The attribute can be assigned dynamic properties by means of the name 
TimeColumnBeginTime. The data type is Date. 


Use the "yyyy-mm-dd hh:mm:ss" format when setting a dynamic time range. 


TimeColumnCaption property 


Caption - TimeColumnCaption 
Defines the caption of the time column. 


The attribute can be assigned dynamic properties by means of the name 
TimeColumnCaption. The data type is STRING. 


TimeColumnCount property 
TimeColumnCount 


Defines the number of time columns configured. 


The attribute can be assigned dynamic properties by means of the name TimeColumnCount. 
The data type is LONG. 


TimeColumnDateFormat property 


Date format - TimeColumnDateFormat 


Defines the date format for visualizing a selected time column. 


The following date formats are available: 


Explanation 
Automatic The date format is set automatically. 
dd.MM.yy Day.Month. Year, e.g. 24.12.07. 
dd.MM.yyyy Day.Month. Year, e.g. 24.12.2007. 
dd/MM/yy Day/Month/Year, e.g. 24/12/07. 
dd/MM/yyyy Day/Month/Year, e.g. 24/12/2007. 


The attribute can be assigned dynamic properties by means of the name 
TimeColumnDateFormat. The data type is STRING. 
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TimeColumnEndTime property 


End time - TimeColumnEndTime 


Defines the end of the time range of a selected time column. 


The attribute can be assigned dynamic properties by means of the name 
TimeColumnEndTime. The data type is Date. 


Use the "yyyy-mm-dd hh:mm:ss" format when setting a dynamic time range. 


TimeColumnForeColor property 


Font color - TimeColumnForeColor 


Specifies the font color of the time column selected. Use the button to open the "Color selection" 
dialog. 


The setting is useful if: 


e The "Use value column colors" option is not activated or 
"TimeColumnUseValueColumnColors" is "FALSE". 


@ The"Font color" option is activated or "UseColumnForeColor" is "TRUE" in the "Use column 
color" field of the "General" tab. 


The attribute can be assigned dynamic properties by means of the name 
TimeColumnForeColor. The data type is LONG. 


TimeColumnHideText property 


TimeColumnHideText 


Sets text format for displaying the content of a time column. 


Value Explanation 
TRUE The content is not displayed in text format. 
FALSE The content is displayed in text format. 


The attribute can be assigned dynamic properties by means of the name 
TimeColumnHideText. The data type is BOOLEAN. 
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TimeColumnHideTitleText property 


TimeColumnHideTitleText 
Sets text format for displaying the time column header. 
Value Explanation 
TRUE The header is not displayed in text format. 
FALSE The header is displayed in text format. 


The attribute can be assigned dynamic properties by means of the name 
TimeColumnHideTitleText. The data type is BOOLEAN. 


TimeColumnindex property 


TimeColumnindex 


References a configured time column. Using this attribute you can assign the values of other 
attributes to a specific time column. 


Values between 0 and "TimeColumnCount" minus 1 are valid for "TimeColumnindex". Attribute 
"TimeColumnCount" defines the number of time columns configured. 


The "TimeColumnindex" attribute can be assigned dynamic properties by means of attribute 
TimeColumnRepos. The data type is LONG. 


TimeColumnLength property 


Length in characters - TimeColumnLength 
Specifies the width of a selected time column. 


The attribute can be assigned dynamic properties by means of the name TimeColumnLength. 
The data type is LONG. 


TimeColumnMeasurePoints property 


Number of measurement points - TimeColumnMeasurePoints 
Defines the number of measurement points to be displayed in the time column selected. 


The attribute can be assigned dynamic properties by means of the name 
TimeColumnMeasurePoints. The data type is LONG. 
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TimeColumnName property 


Object name - TimeColumnName 
Specifies the name of a selected time column. 


The "TimeColumnName" attribute can be assigned dynamic properties by means of attribute 
TimeColumnRename. The data type is STRING. 


TimeColumnRangeType property 


Time range setting - TimeColumnRangeType 


Defines the time range setting for the time column selected. 


Value Description Explanation 

0 Time range Defines the start time and time range of the time column. 

1 Start to end time Defines the start and end time for the time column. 

2 Number of measurement points Defines the start time and the number of measurement points for the time 
column. 


The attribute can be assigned dynamic properties by means of the name 
TimeColumnRangeType. The data type is LONG. 


TimeColumnRemove property 


Remove - TimeColumnRemove 
Removes the selected time column from the list. 


The attribute can be assigned dynamic properties by means of the name 
TimeColumnRemove. The data type is STRING. 


TimeColumnRename property 


TimeColumnRename 
Renames a time column which is referenced by means of "TimeColumnIndex" attribute. 


The attribute can be assigned dynamic properties by means of the name 
TimeColumnRename. "TimeColumnRename" also sets a dynamic attribute 
"TimeColumnName". The data type is STRING. 
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TimeColumnRepos property 


Up/Down - TimeColumnRepos 


Repositions the order of time columns and of corresponding value columns. "Up" and "Down" 
move the time column selected up or down in the list. This moves the time column and 
corresponding value columns in the table towards the front or towards the back. 


The attribute can be assigned dynamic properties by means of the name TimeColumnRepos. 
The data type is LONG. 


TimeColumnShowDate property 


Show date - TimeColumnShowDate 


Enables the display of the date and time in the time column selected. 


Value Explanation 

TRUE Date and time are displayed. The date format is defined in the "Date format" field or by using "TimeCo- 
lumnDateFormat". 

FALSE The date is not displayed. Only the time is displayed. 


The attribute can be assigned dynamic properties by means of the name 
TimeColumnShowDate. The data type is BOOLEAN. 


TimeColumnShowlcon property 


TimeColumnShowlcon 


Enables the display of time column contents as icon. This function is only available in WinCC 
Alarm Control. 


Value Explanation 
TRUE The content is visualized as icon. 
FALSE The content is not visualized as icon. 


The attribute can be assigned dynamic properties by means of the name 
TimeColumnShowlcon. The data type is BOOLEAN. 


TimeColumnShowTitlelcon property 


TimeColumnShowrTitlelcon 


Enables display of the time column header as icon. This function is only available in WinCC 
Alarm Control. 


Value Explanation 
TRUE The header is displayed as icon. 
FALSE The header is not displayed as icon. 
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The attribute can be assigned dynamic properties by means of the name 
TimeColumnShowTitlelcon. The data type is BOOLEAN. 


TimeColumnSort property 
TimeColumnSort 


Defines the sorting order of the time column referenced in "TimeColumnIndex" . 


The following settings are available: 


Value Description Explanation 

0 No No sorting 

1 Ascending Ascending order, starting at the lowest value. 

2 Descending Descending order, starting at the highest value. 


The attribute can be assigned dynamic properties by means of the name TimeColumnSort . 
The data type is LONG. 


TimeColumnSortIndex property 


TimeColumnSortIndex 


Defines the sorting order of the time column referenced in "TimeColumnIndex". The sorting 
criterion is removed from "TimeColumnSort" if you set a "0" value.. 


The attribute can be assigned dynamic properties by means of the name 
TimeColumnSortindex. The data type is LONG. 


TimeColumnTimeFormat property 
Time format - TimeColumnTimeFormat 


Defines the time format for visualizing a selected time column. 


The following time formats are available: 


Value Explanation 

Automatic The time format is set automatically. 

HH:mm:ss.ms Hours:Minutes:Seconds, e.g. 15:35:44.240. 

hh:mm:ss tt Hours:Minutes:Seconds AM/PM, e.g. 03:35:44 PM. 

hh:mmi:ss.ms tt Hours:Minutes:Seconds.Milliseconds AM/PM, e.g. 03:35:44.240 PM. 


The attribute can be assigned dynamic properties by means of the name 
TimeColumnTimeFormat. The data type is STRING. 
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TimeColumnTimeRangeBase property 


Time range - TimeColumnTimeRangeBase 
Defines the time unit for calculating the time range. 


The following time units are available: 


Value Description 
500 500 ms 
1000 1 second 
60000 1 minute 
3600000 1 hour 
86400000 1 day 


The attribute can be assigned dynamic properties by means of the name 
TimeColumnTimeRangeBase. The data type is LONG. 


TimeColumnTimeRangeFactor property 
Time range - TimeColumnTimeRangeFactor 


Defines the factor for calculating the time range. Only integer factors are valid. 


The attribute can be assigned dynamic properties by means of the name 
TimeColumnTimeRangeFactor. The data type is SHORT. 


TimeColumnUseValueColumnColors property 


Use value column colors - TimeColumnUseValueColumnColors 


Defines whether the selected time column will be displayed in the value column colors. 


Value Explanation 

TRUE The colors of the value column are used to display a selected time column. The settings in the "Font color" 
and "Background color" fields are disabled. 

FALSE The colors defined in the "Font color" and "Background color" fields are used to display the selected time 
column. 


The attribute can be assigned dynamic properties by means of the name 
TimeColumnUseValueColumnColors. The data type is BOOLEAN. 


TimeColumnVisible property 


Time columns - TimeColumnVisible 


The list shows the time columns you created. Click a time column entry in the list to adapt the 
properties and to define the time range of the time column. 
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Select the time columns to be displayed in the table from the list. 
Defines whether the selected time column is displayed. 


The attribute can be assigned dynamic properties by means of the name TimeColumn Visible. 
The data type is BOOLEAN. 


TimeFormat - Tolerance 


TimeFormat Property 


Description 
Defines the format of the time specification. 
@ 0: The information is provided in hh:mm 
@ -1: The information is provided in hh:mm:ss 
@ -2: The information is provided in hh:mm:ss.ms 
e -3: The information is provided in hh:mm (full hours) 
e -4: The information is provided in hh:mm:ss (full minutes) 


e -5: The information is provided in hh:mm:ss.ms (full seconds) 


See also 
WinCC Online Table Control (before WinCC V7) (Page 292) 
Screenltem Object (Page 125) 
TimeJump Property 
Description 
WinCC Online Trend Control 
The "Index" property references a trend. "TimeJump" defines whether the time jumps in the 
archive should be identified by the color defined in "TimeJumpColor". 
WinCC Online Trend Control 
The value of this attribute cannot be changed. Read only access. 
See also 


WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
Screenltem Object (Page 125) 
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TimeJumpColor Property 


Description 


See also 


WinCC Online Trend Control 


The "Index" property references a trend. "TimeJumpColor" defines the color identifying the 
time jumps in the archive. Whether the information is evaluated is dependent on the value of 
the "TimeJump" property. The color is defined as an RGB value. LONG write-read access. 


WinCC Online Trend Control 
The value of this property cannot be changed. Read only access. 


Screenltem Object (Page 125) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 


TimeOverlap Property 


Description 


See also 


WinCC Online Trend Control 


The "Index" property references a trend. "TimeOverlap" defines whether the time overlaps in 
the archive should be identified by the color defined in "TimeOverlapColor". 


WinCC Online Trend Control 
The value of this property cannot be changed. Read only access. 


WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
Screenltem Object (Page 125) 


TimeOverlapColor Property 


Description 
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WinCC Online Trend Control 


The "Index" property references a trend. "TimeOverlapColor" defines the color identifying the 
time overlaps in the archive. Whether the information is evaluated depends on the value of the 
"TimeOverlap" attribute. The color is defined as an RGB value. 
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WinCC Online Trend Control 
The value of this property cannot be changed. Read only access. 


WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
Screenltem Object (Page 125) 


TimeRange Property 


Description 


See also 


The "Index" property references a column pair or a trend. "TimeRange" defines how the time 
range to be displayed should be defined. 


e 0: The time range to be displayed is defined by a start time ("BeginTime") and end time 
("EndTime"). 


e -1: The time range to be displayed is defined by a start time ("BeginTime") and a time range 
("TimeRangeBase" and "TimeRangeFactor"). 


WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
Screenltem Object (Page 125) 


TimeRangeBase Property 


Description 


See also 


The "Index" property references a column pair or a trend. The time range to be displayed for 
this column pair/trend results from multiplying the values "TimeRangeBase" and 
"TimeRangeFactor", whereby the value "TimeRangeBase" is interpreted in milliseconds. 


The "TimeRangeBase" and "TimeRangeFactor" properties are only evaluated when the 
"TimeRange" property is set, i.e. has the value "-1". 


WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
Screenltem Object (Page 125) 
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TimeRangeFactor Property 


Description 


The "Index" property references a column pair or a trend. The time range to be displayed for 
this column pair/trend results from multiplying the values "TimeRangeBase" and 
"TimeRangeFactor", whereby the value "TimeRangeBase" is interpreted in milliseconds. 


The "TimeRangeBase" and "TimeRangeFactor" properties are only evaluated when the 
"TimeRange" property is set, i.e. has the value "-1". 


See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
Screenltem Object (Page 125) 

TimeStamp Property 

Description 
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Reads the time stamp of the last read access of a tag. The time stamp is returned in local time. 
DATE (read only) 


The VBS standard function "FormatDateTime(Date[, NamedFormat])" enables the time stamp 
property to be output in plain text. The output is dependent on the current language setting. 
The language setting can be set using the VBS standard function SetLocale(). 


By implementing the second parameter of the FormatDate() function and further VBS standard 
functions such as Year, WeekDay, Day, Hour, Minute, Second enable the information, required 
by the user, to be split. Use the WeekdayName function to receive the name of the weekday 
for WeekDay. 
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Example: 


"VBS87 

Dim objTag 
Dim IngCount 
ingCount = 0 
Set objTag = 
objTag.Read 
SetLocale ("en-gb") 


HMIRuntime.Tags ("Tagl1") 


sgBox FormatDateTime (objTag.TimeStamp) "Output: e.g. 06/08/2002 9:07:50 
sgBox Year (objTag.TimeStamp) "Output: e.g. 2002 
sgBox Month (objTag.TimeStamp) "Output: e.g. 8 
sgBox Weekday (objTag.TimeStamp) "Output: e.g. 3 
sgBox WeekdayName (Weekday (objTag.TimeStamp) ) "Output: e.g. Tuesday 
sgBox Day (objTag.TimeStamp) "Output: e.g. 6 
sgBox Hour (objTag.TimeStamp) "Output: e.g. 9 
sgBox Minute (objTag.TimeStamp) "Output: e.g. 7 
sgBox Second(objTag.TimeStamp) "Output: e.g. 50 
For IngCount = 0 To 4 
sgBox FormatDateTime(objTag.TimeStamp, lngCount) 
Next 
"IngCount = 0: Output: e.g. 06/08/2002 9:07:50 
"IngCount = 1: Output: e.g. 06 August 2002 
"IngCount = 2: Output: e.g. 06/08/2002 
‘IngCount = 3: Output: e.g. 9:07:50 
"IngCount = 4: Output: e.g. 9:07 
Example: 
The following example issues the time stamp of the tag "Tag1": 
"VBS88 


Dim objTag 

Set objTag = HMIRuntime.Tags ("Tagl") 
objTag.Read 

MsgBox objTag.TimeStamp 


See also 
Tag Object (Page 137) 
Alarms object (list) (Page 110) 
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TimeStepBase property 


Precision - TimeStepBase 


Defines the precision of the time stamp displayed in a table. 


Calculate the precision by multiplying the factor with the time unit. Enter factor "3" and time 
unit "1s" to display all values which were generated within 3 seconds in the same row, for 
example. 


Description Explanation 
0 Exact Only values with precisely the same time stamp are displayed in a table 
row. 
100 100 ms All values generated within 100 milliseconds are grouped in a table row. 
250 250 ms All values generated within 250 milliseconds are grouped in a table row. 
500 500 ms All values generated within 500 milliseconds are grouped in a table row. 
1000 1s All values generated within 1 second are grouped in a table row. 


The attribute can be assigned dynamic properties by means of the name TimeStepBase. The 
data type is LONG. 


TimeStepFactor property 


Precision - TimeStepFactor 


Defines the precision of the time stamp displayed in a table. 


Calculate the precision by multiplying the factor with the time unit. Enter factor "3" and time 
unit "1s" to display all values which were generated within 3 seconds in the same row. 


The factor entered is disabled if "Exact" is selected for the time unit or "0" is selected for 
"TimeStepBase". 


The attribute can be assigned dynamic properties by means of the name TimeStepFactor. The 
data type is LONG. 


TimeZone Property 


Description 
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Defines the time zone used as a basis for displaying time values. Four settings are possible: 
e Local time zone 

e Server's time zone 

e UTC (Universal Time Coordinated) 


e Apply project settings (=> Use WinCC Explorer and access the computer's properties page 
to define the time mode specifically for the computer. The following are available for 
selection: WinCC V50 (Compatibility mode => Display as was standard in the individual 
display sections to V5 ), local time and UTC. 
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See also 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 

TitleColor property 


Table header background - TitleColor 


Specifies the background color of the table headers. The button opens the "Color selection" 
dialog. 


The attribute can be assigned dynamic properties by means of the name TitleColor. The data 
type is LONG. 


TitleCut property 


Shorten contents - TitleCut 


Truncates the content of column headers if the column is insufficient. 


Value Explanation 
TRUE The column headers are truncated. 
FALSE The column headers are not truncated. 


The attribute can be assigned dynamic properties by means of the name TitleCut . The data 
type is BOOLEAN. 


TitleCut property (before WinCC V7) 


Description 


See also 


Defines whether the content of the fields of a title bar should be shortened if the column width 
is too small. Write/Read access. 


WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 
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TitleDarkShadowColor property 


Dark shading color - TitleDarkShadowColor 
Specifies the color of the dark side of shading. The button opens the "Color selection" dialog. 
The setting is only active if the "Shading Color" option or "TitleStyle" is activated. 


The attribute can be assigned dynamic properties by means of the name 
TitleDarkShadowColor. The data type is LONG. 


TitleForeColor property 


Table header font color - TitleForeColor 
Specifies the color of the table header. The button opens the "Color selection" dialog. 


The attribute can be assigned dynamic properties by means of the name TitleForeColor. The 
data type is LONG. 


TitleGridLineColor property 


Color of the divider / header - TitleGridLineColor 


Defines the color of row/column dividers in the table header. The button opens the "Color 
selection" dialog. 


The attribute can be assigned dynamic properties by means of the name TitleGridLineColor. 
The data type is LONG. 


TitleLightShadowColor property 


Bright shading color - TitleLightShadowColor 
Specifies the color of the bright side of shading. The button opens the "Color selection" dialog. 
The setting is only active if the "Shading Color" option or "TitleStyle" is activated. 


The attribute can be assigned dynamic properties by means of the name 
TitleLightShadowColor. The data type is LONG. 


Titleline Property 


Description 


TRUE, when the control has a title bar and it can be moved in Runtime. BOOLEAN write-read 
access. 
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See also 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 

TitleSort property 


Sort by column title- TitleSort 


Defines how to trigger sorting by column title. You can only sort by column title if the "Auto- 
scrolling" option is deactivated. 


Description Explanation 
0 No Sorting by column title is not possible. 
1 With click Sorting is triggered by clicking in the column header. 
2 With double-click Sorting is triggered by double-clicking in the column title. 
The attribute can be assigned dynamic properties by means of the name TitleSort. The data 
type is LONG. 
TitleStyle property 


Shading color - TitleStyle 
Specifies whether to set a shading color for the table header. 


Value Description Explanation 
0 Flat Disables the use of shading colors. Flat header style. 
1 Button Enables the use of shading colors. 3D representation of the header. 


The attribute can be assigned dynamic properties by means of the name TitleStyle. The data 
type is LONG. 


Toggle Property 


Description 


TRUE, when the button or round button should lock after being operated in Runtime. 
BOOLEAN write-read access. 
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See also 


Round Button (Page 209) 
Screenltem Object (Page 125) 


ToleranceHigh Property 


Description 


See also 


Defines or returns the limit value for "Tolerance high". 

The type of the evaluation (in percent or absolute) is defined in the "TypeToleranceHigh" 
property. 

The monitoring of the limit value is only valid if the "CheckToleranceHigh" property is set to 
"TRUE". 


Bar (Page 174) 
Screenltem Object (Page 125) 


ToleranceLow Property 


Description 


See also 


Toolbar 


Toolbar Property 


Description 
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Defines or returns the limit value for "Tolerance low". 

The type of the evaluation (in percent or absolute) is defined in the "TypeToleranceLow" 
property. 

The monitoring of the limit value is only valid if the "CheckToleranceLow" property is set to 
"TRUE". 


Bar (Page 174) 
Screenltem Object (Page 125) 


TRUE, when a toolbar is to be displayed. BOOLEAN write-read access. 
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See also 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 


ToolbarAlignment property (before WinCC V7) 


Description 
Defines or returns the position of the toolbar. Write/Read access. 


See also 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


ToolbarAlignment Property 
Alignment - ToolbarAlignment 


Defines the orientation of the Control toolbar. 


The following settings are available: 


Value | Description Explanation 

0 Top The toolbar is aligned to the top edge. 

1 Bottom The toolbar is aligned to the bottom edge. 
2 Left The toolbar is aligned to the left edge. 

3 Right The toolbar is aligned to the right edge. 


The attribute can be assigned dynamic properties by means of the name ToolbarAlignment. 
The data type is LONG. 


ToolbarBackColor property 


Background color - ToolbarBackColor 


Specifies the background color of the toolbar. Open the "Color selection" dialog by clicking the 
button. 
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The background color you configured is only displayed if the "Display" option is activated or 
"ToolbarUseBackColor" is "TRUE". 


The attribute can be assigned dynamic properties by means of the name ToolbarBackColor. 
The data type is LONG. 


ToolbarButtonActive property 


Active - ToolbarButtonActive 


Activates a button function in Runtime. Clicking the button in Runtime triggers the 
corresponding function. 


Value Explanation 
TRUE The button function is enabled. 
FALSE The button function is disabled. You can assign custom functions to the button by means of scripting. 


The attribute can be assigned dynamic properties by means of the name 
ToolbarButtonActive. The data type is BOOLEAN. 


ToolbarButtonAdd property 


New - ToolbarButtonAdd 


Creates a new, user-defined button function. The name set by WinCC can be edited in the 
"Object name" field. 


The attribute can be assigned dynamic properties by means of the name ToolbarButtonAdd . 
The data type is STRING. 


ToolbarButtonBeginGroup property 


Separator - ToolbarButtonBeginGroup 


Inserts a leading separator (vertical line) for the selected button function on the toolbar. These 
separators can be used to group the icons of the button functions. 


Value Explanation 
TRUE A separator prefix is inserted for the button function selected. 
FALSE A separator prefix is not inserted for the button function selected. 


The attribute can be assigned dynamic properties by means of the name 
ToolbarButtonBeginGroup. The data type is BOOLEAN. 
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ToolbarButtonClick 
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Triggers the function linked to the toolbar button. Programmers can use the "ID" to call the 
corresponding button function. 


ID Button function ID Button function 

1 "Help" 21 "Next message" 

2 "Configuration dialog" 22 "Last message" 

3 "Message list". 23 "Info text dialog" 

4 "Short-term archive list". 24 "Comments dialog" 
5 "Long-term archive list" 25 "Loop In Alarm" 

6 "Lock List". 26 "Lock message" 

7 "Hit List" 27 "Enable message" 
8 "List of messages to be hidden" 28 "Hide messages" 

9 "Ackn. Central Signaling Devices" 29 ‘Unhide messages" 
10 "Single acknowledgment" 30 "Sort dialog" 

11 "Group acknowledgement" 31 "Time base dialog" 
18 "Emergency acknowledgement" 32 "Copy rows" 

13 "Selection dialog" 33 "Connect backup" 
14 "Display options dialog" 34 "Disconnect backup" 
15 "Lock dialog" 36 "First page" 

17 "Print" 37 "Previous page" 
35 "Export data" 38 "Next page" 

12 "Autoscroll" 39 "Last page" 

19 "First message" 1001 "User-defined 1" 
20 "Previous message" 


The attribute can be assigned dynamic properties by means of the name ToolbarButtonClick. 
The data type is LONG. 


ToolbarButtonClick FunctionTrendControl property 


ToolbarButtonClick 


Triggers the function linked to the toolbar button. Programmers can use the "ID" to call the 
corresponding button function. 


ID Button function ID Button function 

1 "Help" 13 "Select time range" 
2 "Configuration dialog" 14 "Previous trend" 

4 "Zoom area" 15 "Next trend" 

5 "Zoom +/-" 16 "Stop" 

6 "Zoom X axis +/-" 16 "Start" 
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7 "Zoom Y axis +/-" 17 "Print" 

8 "Shift trend range" 20 "Export data" 

9 "Shift axes range" 3 "Ruler" 

10 "Original view" 18 "Connect backup" 

11 "Select data connection" 19 "Disconnect backup" 
12 "Select trends" 1001 "User-defined 1" 


The attribute can be assigned dynamic properties by means of the name ToolbarButtonClick. 
The data type is LONG. 


ToolbarButtonClick OnlineTableControl property 
ToolbarButtonClick 


Triggers the function linked to the toolbar button. Programmers can use the "ID" to call the 
corresponding button function. 


ID Button function ID Button function 

1 "Help" 13 "Next column" 

2 "Configuration dialog" 14 "Stop" 

3 "First data record" 14 "Start" 

4 "Previous data record" 15 "Print" 

5 "Next data record" 20 "Export data" 

6 "Last data record" 16 "Define statistics area" 
7 "Edit" 17 "Calculate statistics" 

8 "Copy rows" 18 "Connect backup" 

9 "Select data connection" 19 "Disconnect backup" 
10 "Select columns" 21 "Create archive value" 
11 "Select time range" 1001 "User-defined 1" 

12 "Previous column" 


The attribute can be assigned dynamic properties by means of the name ToolbarButtonClick. 
The data type is LONG. 


ToolbarButtonClick OnlineTrendControl property 


ToolbarButtonClick 


Triggers the function linked to the toolbar button. Programmers can use the "ID" to call the 
corresponding button function. 


ID Button function ID Button function 

1 "Help" 17 "Select time range" 
2 "Configuration dialog" 18 "Previous trend" 

3 "First data record" 19 "Next trend" 

4 "Previous data record" 20 "Stop" 
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5 "Next data record" 20 "Start" 

6 "Last data record" 21 "Print" 

8 "Zoom area" 26 "Export data" 

9 "Zoom +/-" 7 "Ruler" 

10 "Zoom time axis +/-" 22 "Define statistics area" 
11 "Zoom value axis +/-" 23 "Calculate statistics" 
12 "Shift trend range" 24 "Connect backup" 
13 "Shift axes range" 25 "Disconnect backup" 
14 "Original view" 27 "Relative axis" 

15 "Select data connection" 1001 "User-defined 1" 

16 "Select trends" 


The attribute can be assigned dynamic properties by means of the name ToolbarButtonClick. 
The data type is LONG. 


ToolbarButtonClick RulerControl property 


ToolbarButtonClick 


Triggers the function linked to the toolbar button. Programmers can use the "ID" to call the 
corresponding button function. 


ID Button function 
"Hel p" 
"Configuration dialog" 


"Ruler window" 


"Statistics range" 


"Statistics" 
"Print" 

"Export data" 
1001 "User-defined 1" 


NID) Oay;RloO;m]— 


The attribute can be assigned dynamic properties by means of the name ToolbarButtonClick. 
The data type is LONG. 


ToolbarButtonClick SysdiagControl property 


ToolBarButtonClick 


Triggers the function linked to the toolbar button. Programmers can use the "ID" to call the 
corresponding button function. 


ID Button function 
"Configuration dialog" 

2 "Overview" 

3 "Back" 
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"Oo pen" 


"Diagnostics buffer" 


"Update diagnostic buffer" 


"Sort dialog" 
"Print" 
"Export data" 


O;SOINIO| OA! 


The attribute can be assigned dynamic properties using the name ToolbarButtonClick. The 
data type is LONG. 


ToolbarButtonClick UserAdminControl property 


ToolbarButtonClick 


Triggers the function linked to the toolbar button. Programmers can use the "ID" to call the 
corresponding button function. 


ID Button function ID Button function 

1 "Help" 9 "Log on" 

2 "Configuration dialog" 10 "Log off" 

3 "Group list" 11 "Change password" 

4 "User list" 12 "Import user administration" 
5 "Edit" 13 "Export user administration" 
6 "Add" 14 "Sort dialog" 

7 "Authorization levels" 15 "Print" 

8 "Delete" 16 "Export data" 


The attribute can be assigned dynamic properties using the name ToolbarButtonClick. The 
data type is LONG. 


ToolbarButtonClick UserArchiveControl property 


ToolbarButtonClick 


Triggers the function linked to the toolbar button. Programmers can use the "ID" to call the 
corresponding button function. 


ID Button function ID Button function 

1 "Help" 12 "Read tags" 

2 "Configuration dialog" 13 "Write tags" 

3 "Select data connection" 14 "Import archive" 
4 "First row" 15 "Export archive" 
5 "Previous row" 16 "Sort dialog" 

6 "Next row" 17 "Selection dialog" 
7 "Last row" 18 "Print" 

8 "Delete rows" 20 "Export data" 
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9 "Cut rows" 19 "Time base dialog" 
10 "Copy rows" 1001 "User-defined 1" 
11 "Insert rows" 


The attribute can be assigned dynamic properties by means of the name ToolbarButtonClick. 
The data type is LONG. 


ToolbarButtonCount property 


ToolbarButtonCount 
Defines the number of configurable button functions. 


The attribute can be assigned dynamic properties by means of the name 
ToolbarButtonCount. The data type is LONG. 


ToolbarButtonEnabled property 


ToolbarButtonEnabled 
Enables operation of custom toolbar buttons. 


The attribute can be assigned dynamic properties by means of the name 
ToolbarButtonEnabled. The data type is BOOLEAN. 


ToolbarButtonHotKey property 


Hotkey - ToolbarButtonHotKey 
Shows the hotkey for a button function selected. 


You create or edit a hotkey by clicking in the "Hotkey" field and pressing the button or key 
shortcut required. 


The attribute can be assigned dynamic properties by means of the name 
ToolbarButtonHotKey. The data type is LONG. 


ToolbarButtonID property 


Object ID - ToolbarButtonID 
Unique ID number for the selected button function. WinCC assigns this read only ID number. 


The attribute can be assigned dynamic properties by means of the name ToolbarButtonID. 
The data type is LONG. 
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ToolbarButtonIndex property 


ToolbarButtonIndex 


References a button function. Using this attribute you can assign the values of other attributes 
to a specific button function. 


Values between 0 and "ToolbarButtonIndex" minus 1 are valid for "ToolbarButtonCount". 
Attribute "ToolbarButtonCount" defines the number of configurable button functions. 


The "ToolbarButtonIndex" attribute can be assigned dynamic properties by means of attribute 
ToolbarButtonRepos. The data type is LONG. 


ToolbarButtonLocked property 


ToolbarButtonLocked 
Enables/disables the display of the pressed state of a user-defined toolbar button. 


The attribute can be assigned dynamic properties by means of the name 
ToolbarButtonLocked. The data type is BOOLEAN. 


ToolbarButtonName property 


Object name - ToolbarButtonName 
Shows the name for the selected button function. You rename user-defined button functions. 


The "ToolbarButtonName" attribute can be assigned dynamic properties by means of attribute 
ToolbarButtonRename. The data type is STRING. 


ToolbarButtonPasswordLevel property 


Operator authorization - ToolbarButtonPasswordLevel 


Shows the authorization for a button function selected. You can edit the authorization using 
the selection button. 


Authorizations are configured in the "User Administrator" editor. 


The attribute can be assigned dynamic properties by means of the name 
ToolbarButtonPasswordLevel. The data type is LONG. 


ToolbarButtonRemove property 


Remove - ToolbarButtonRemove 


Removes the selected button function from the list. Only user-defined button functions can be 
removed. 
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The attribute can be assigned dynamic properties by means of the name 
ToolbarButtonRemove. The data type is STRING. 


ToolbarButtonRename property 


ToolbarButtonRename 


Renames a custom toolbar element which is referenced by means of "ToolbarButtonIndex" 
attribute. 


The attribute for custom elements can be assigned dynamic properties by means of the name 
ToolbarButtonRename. "ToolbarButtonRename" also sets a dynamic attribute 
"ToolbarButtonName". The data type is STRING. 


ToolbarButtonRepos property 


Up/Down - ToolbarButtonRepos 


Changes the sorting order of button functions. "Up" and "Down" move the button function 
selected up or down in the list. This moves the button function in the toolbar of a Control towards 
the front or towards the back. 


The attribute can be assigned dynamic properties by means of the name 
ToolbarButtonRepos. The data type is LONG. 


ToolbarButtonSize property 
Button size in pixels - ToolbarButtonSize 
Defines the size of the buttons in the toolbar. 


With the maximum value of 280 pixels, the button size can be ten times larger than the original 
size of 28 pixels. 


The following behavior results for the button size depending on the configured value: 


Value of the button size Behavior 
Value <0 Invalid value. The most recent valid value is used. 


0 < value § original size of button The original size of the button is used. "Toolbar- 
ButtonSize" is set to the default (= 0). 


Original size of the button < value < maximum val- | The configured value is used. 
ue 


Maximum value < value Invalid value. The most recent valid value is used. 


With a large button size, please note that in some cases not all buttons may be displayed in 
the control. To show all activated buttons in Runtime, you must therefore extend the control 
or activate fewer buttons as required. 


You can create a dedicated button to zoom in or out of the toolbar in Runtime. For instructions, 
refer to the example "How to configure a user-defined toolbar button with a self-created 
selection dialog" in the documentation "VBS for Creating Procedures and Actions". 
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The attribute can be assigned dynamic properties by means of the name ToolbarButtonSize . 
The data type is LONG. 


ToolbarButtonTooltipText property 
ToolbarButtonTooltipText 


Specifies the tooltip text for the button. 


The attribute can be assigned dynamic properties by means of the name 
ToolbarButtonTooltipText. The data type is STRING. 


ToolbarButtonUserDefined property 


ToolbarButtonUserDefined 
Indicates whether the project engineer has added a new user-defined toolbar button. 


Value Explanation 
TRUE The toolbar button is assigned a user-defined function. 
FALSE The toolbar button is defined by the system. 


The attribute can be assigned dynamic properties by means of the name 
ToolbarButtonUserDefined. The data type is BOOLEAN. 


ToolbarButtonVisible property 


Button functions - ToolbarButtonVisible 
Select the button functions to be displayed in the toolbar from the list. 


Click a list entry to adapt the properties, or to change the position in the status bar of the Control 
by means of the "Up" and "Down" buttons. 


The attribute can be assigned dynamic properties by means of the name 
ToolbarButtonVisible . The data type is BOOLEAN. 


ToolbarButtons Property 


Description 


Defines or returns the buttons contained in the toolbar by setting or resetting the corresponding 
bits. Each button is assigned a bit. There are no limitations as to the bit combinations. 


Bit - Value (hex) ; Value (dec) ; Button: 
e 0-0x00000001; 1; Message List 
e 1 -0x00000002; 2; Short-term archive list 
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@ 2-0x00000004; 4; Long-term archive list 

@ 3-0x00000008; 8; Acknowledgment of central signaling device 
@ 4-0x00000010; 16; Single Acknowledgment 

@ 5 -0x00000020; 32; Group acknowledgment 

e 6 - 0x00000040; 64; Autoscroll 

@ 7 -0x00000080; 128; Selection Dialog 

© 8 -0x00000100; 256; Lock Dialog 

@ 9-0x00000200; 512; Print message log 

@ 11 -0x00000800; 2048; Emergency acknowledgment 
@ 12 -0x00001000; 4096; First message 

@ 13 -0x00002000; 8192; Last message 

@ 14 -0x00004000; 16384; Next message 

@ 15-0x00008000; 32768; Previous message 

@ 16 -0x00010000; 65536; Infotext Dialog 

@ 17 -0x00020000; 131072; Comment Dialog 

e 18 - 0x00040000; 262144; Loop in Alarm 

e 20 - 0x00100000; 1048576; Print current view 

@ 21 - 0x00200000; 2097152; Lock list 

@ 22 - 0x00400000; 4194304; Lock/release message 
e 23 - 0x00800000; 8388608; Sorting Dialog 

@ 24 -0x01000000; 16777216; Time basis dialog 

e 25 - 0x02000000; 33554432; Hit list 


In order to display more buttons, their values must be logically linked with OR. Write/Read 
access. 


See also 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 
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ToolbarHotKeys Property 


Description 
Defines or returns hotkeys of the buttons in the toolbar. Write/Read access. 


See also 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


ToolbarShowTooltips property 


Tooltips - ToolbarShowTooltips 
Enables the display of tooltips for the button functions in Runtime. 


Value Explanation 
TRUE Enables the display of tooltips. 
FALSE Disables the display of tooltips. 


The attribute can be assigned dynamic properties by means of the name 
ToolbarShowTooltips. The data type is BOOLEAN. 


Attribute "ToolbarButtonTooltipT ext" defines the tooltip text. 


ToolbarUseBackColor property 


Show background color - ToolbarUseBackColor 
Enables the display of the background color for a toolbar. 


Value Explanation 
TRUE Enables the display of the background color of a toolbar. 
FALSE Disables the display of the background color of a toolbar. 


The attribute can be assigned dynamic properties by means of the name 
ToolbarUseBackColor. The data type is BOOLEAN. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
640 System Manual, 02/2016, A5E37536061-AA 


VBS for Creating Procedures and Actions 


7.14 VBS Reference 


ToolbarUseHotKeys property 


Hotkeys - ToolbarUseHotKeys 


Activates the hotkeys for button functions in Runtime. Insert the hotkeys for button functions 
in the "Hotkey" field. 


Value Explanation 
TRUE The hotkeys are activated. 
FALSE The hotkeys are deactivated. 
The attribute can be assigned dynamic properties by means of the name 
ToolbarUseHotKeys. The data type is BOOLEAN. 
ToolbarVisible property 


Show toolbar - ToolbarVisible 


Enables the display of the Control toolbar. 


Value Explanation 
TRUE Enables the display of the toolbar. 
FALSE Disables the display of the toolbar. 


The attribute can be assigned dynamic properties by means of the name ToolbarVisible . The 
data type is BOOLEAN. 


ToolTip - TrendLower 
ToolTipText Property 


Description 


Defines or returns the text to be displayed as a tooltip when the mouse is positioned over the 
object. 


STRING (write-read access) 
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Example: 


The following example assigns a tool tip text to every object in the picture "NewPDL1": The 
picture "NewPDL1" comprises only objects containing the ToolTipText property: 


"VBS89 

Dim objScreen 

Dim objScriItem 

Dim IngIndex 

Dim strName 

IngIndex = 1 

Set objScreen = HMITRuntime.Screens ("NewPDL1") 
For IngIndex = 1 To objScreen.ScreenItems.Count 
strName = objScreen.ScreenItems (IngIndex) .ObjectNam 
Set objScrItem = objScreen.ScreenItems (strName) 
' 


"Assign tooltiptexts to the objects 
objScritem.ToolTipText = "Name of object is " & strName 
Next 


See also 
Radio box (Page 207) 
Status display (Page 199) 
Connector (Page 167) 
Text list (Page 196) 
Static text (Page 165) 
Slider (Page 212) 
Group Display (Page 194) 
Rounded rectangle (Page 162) 
Round Button (Page 209) 
Rectangle (Page 159) 
Polyline (Page 158) 
Polygon (Page 156) 
OLE object (Page 191) 
Line (Page 154) 
Pie segment (Page 152) 
Circular arc (Page 151) 
Circle (Page 149) 
Group (Page 300) 
Graphic Object (Page 187) 
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Ellipse segment (Page 147) 
Ellipse arc (Page 146) 

Ellipse (Page 144) 

I/O Field (Page 184) 

Check box (Page 204) 

Button (Page 201) 

Bar (Page 174) 

Customized Object (Page 298) 
3D Bar (Page 169) 


Top Property 

Function 
Defines or returns the Y-coordinate of an object (measured from the top left edge of the picture) 
in pixels. The Y-coordinate relates to the top left corner of the rectangle enclosing the object. 
LONG (write-read access) 

Example: 
The following example shifts all objects in the picture "NewPDL1" 5 pixels upwards: 

"'VBS90 


Dim objScreen 

Dim objScriItem 

Dim IngIndex 

Dim strName 

IngIndex = 1 

Set objScreen = HMTRuntime.Screens ("NewPDL1") 
For lngIndex = 1 To objScreen.ScreenItems.Count 
strName = objScreen.ScreenItems (lngIndex) .ObjectNam 
Set objScrItem = objScreen.ScreenItems (strName) 
objScriItem.Top = objScritem.Top - 5 

Next 


See also 
Left Property (Page 476) 
Screenltem Object (Page 125) 
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TopConnectedConnectionPointindex Property 


Description 


See also 


Specifies or sets the index number of the top connecting point. 


LONG write-read access. 


Connector (Page 167) 
Screenltem Object (Page 125) 


TopConnectedObjectName Property 


Description 


See also 


Specifies or sets the object name of the object which is docked on at the bottom connecting 
point. 


LONG write-read access. 


Connector (Page 167) 
Screenltem Object (Page 125) 


Transparency property 


Description 
Defines and returns the percentage transparency of the object. 
0 = no transparency; 100 = complete transparency (invisible) 
The text and fields of the graphic objects are only transparent at "100." 
In runtime, a completely transparent object (invisible) is also functional. 
Transparent Property 
Description 
TRUE, when the button appears completely filled in the color specified in "BackColor". 
BOOLEAN write-read access. 
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See also 
WinCC Push Button Control (Page 269) 
Screenltem Object (Page 125) 


Trend Property 


Description 


TRUE, when the tendency (rising or falling) of the measuring value being monitored should 
be displayed by a small arrow. BOOLEAN write-read access. 


See also 
Bar (Page 174) 
Screenltem Object (Page 125) 


TrendActualize property 


Update -TrendActualize 


Enables the update of a selected trend. 


Value Explanation 

TRUE Enables updates of the trend selected. 

FALSE Disables updates of the trend selected. This setting can be useful when comparing a logged trend with a current 
trend. 


The attribute can be assigned dynamic properties by means of the name TrendActualize. The 
data type is BOOLEAN. 


TrendAdd property 


New - TrendAdd 
Creates a new trend. 


The attribute can be assigned dynamic properties by means of the name TrendAdd. The data 
type is STRING. 


TrendAutoRangeBeginTagName property 


TrendAutoRangeBeginTagName 


This attribute sets the low limit tag for the range of values if the range of values is calculated 
automatically by means of online tags. 
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The attribute can be assigned dynamic properties by means of the name 
TrendAutoRangeBeginTagName. The data type is STRING. 


TrendAutoRangeBeginValue property 


TrendAutoRangeBeginValue 


This attribute sets the low limit tag for the range of values if the range of values is calculated 
based on the configuration of high and low limits. 


The attribute can be assigned dynamic properties by means of the name 
TrendAutoRangeBeginValue. The data type is DOUBLE. 


TrendAutoRangeEndTagName property 


TrendAutoRangeEndTagName 


This attribute sets the high limit tag for the range of values if the range of values is calculated 
automatically by means of online tags. 


The attribute can be assigned dynamic properties by means of the name 
TrendAutoRangeEndTagName. The data type is STRING. 


TrendAutoRangeEndValue property 


TrendAutoRangeEndValue 


This attribute sets the high limit tag for the range of values if the range of values is calculated 
based on the configuration of high and low limits. 


The attribute can be assigned dynamic properties by means of the name 
TrendAutoRangeEndValue. The data type is DOUBLE. 


TrendAutoRangeSource property 


TrendAutoRangeSource 


Defines the mode for automatic calculation of the range of values of trend data. 


Value Description Explanation 

0 Display data The range of values is calculated automatically based on the data displayed. 

1 Value range The range of values is defined based on its configured low and high limit. The low and high 
limits are emulated in the "TrendAutoRangeBeginValue" and "TrendAutoRangeEndValue" at- 
tributes. 

2 Online tags The low and high limits of the range of values are derived from the values of connected online 
tags. The low and high limits are emulated in the "TrendAutoRangeBeginTagName" and 
"TrendAutoRangeEndTagName" attributes. 
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The attribute can be assigned dynamic properties by means of the name 
TrendAutoRangeSource. The data type is LONG. 


TrendBeginTime property 


Start time - TrendBeginTime 
Defines the start time of the time range for data transfer to the selected trend. 


The attribute can be assigned dynamic properties by means of the name TrendBeginTime. 
The data type is Date. 


TrendColor property 
Trend color - TrendColor 


Specifies the trend color. Open the "Color selection" dialog by clicking the button. 


The attribute can be assigned dynamic properties by means of the name TrendColor. The data 
type is LONG. 


LTrendColor property (before WinCC V7) 


Description 
Determines the color of the trend display or returns it. 
The trend display indicates the tendency (rising or falling) of the measuring value being 
monitored by a small arrow. In order to activate the trend display, the Trend property must be 
set to "True". LONG write-read access. 

See also 
Bar (Page 174) 
Screenltem Object (Page 125) 

TrendCount property 

TrendCount 


Defines the number of configured trends. 


The attribute can be assigned dynamic properties by means of the name TrendCount. The 
data type is LONG. 
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TrendEndTime property 


End time - TrendEndTime 
Defines the end of the time range for data connections of a selected trend. 


The attribute can be assigned dynamic properties by means of the name TrendEndTime. The 
data type is Date. 


TrendExtendedColorSet property 


Extended - TrendExtendedColorSet 
Enables configuration of the point and fill colors and the display of colors in Runtime. 


Explanation 
TRUE The "Point color" and "Fill color" field settings can be configured and are active in Runtime. 


FALSE | The "Point color" and "Fill color" field settings cannot be configured and are inactive in 
Runtime. 


The attribute can be assigned dynamic properties by means of the name 
TrendExtendedColorSet. The data type is BOOLEAN. 


TrendFill property 


Filled - TrendFill 
Specifies if the area beneath the trend is to be filled. 
Value Explanation 
TRUE The area beneath the trend is shown filled. You can define the trend color as fill color if the "Advanced" 
option is deactivated. 
The text background is displayed in the trend color for the trend type "Values". The background color 
of the control is used as text color. 
FALSE The trend is not visualized with fill color. 


The attribute can be assigned dynamic properties by means of the name TrendFill. The data 
type is BOOLEAN. 


TrendFillColor property 


Fill color - TrendFillColor 
Specifies the fill color of the trend. The text fill color is specified for the trend type "Values". 


The fill color is used if the "Filled" option is activated or "TrendFill" is "TRUE". Open the "Color 
selection" dialog by clicking the button. 
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The configuration is only possible if the "Advanced" option is activated or 
"TrendExtendedColorSet" is "TRUE". 


The attribute can be assigned dynamic properties by means of the name TrendFillColor. The 
data type is LONG. 


TrendIndex property 


Trendindex 


References a configured trend. Using this attribute you can assign the values of other attributes 
to a specific trend. The index must always be set before you change the properties of a trend 
in runtime. 


Values between 0 and "TrendIndex" minus 1 are valid for "TrendCount". Attribute "TrendCount" 
defines the number of trends configured. 


The "TrendIndex" attribute can be assigned dynamic properties by means of attribute 
TrendRepos. The data type is LONG. 


TrendLabel property 


Label - TrendLabel 


Defines the label of the trend selected. The label is displayed in Runtime if the value at attribute 
"UseTrendNameAsLabel" is "FALSE". 


The attribute can be assigned dynamic properties by means of the name TrendLabel. The data 
type is STRING. 


TrendLineStyle property 
Line style - TrendLineStyle 


Defines the line style for trend visualization. 


The following settings are available: 


Value Description Explanation 

0 Solid The trend is visualized as solid line. 

1 Dashed The trend is visualized as dashed line. 

2 Dotted The trend is visualized as dotted line. 

3 Dash dot The trend is visualized as dot-dash line. 

4 Dash Dot Dot The trend is visualized as dash-dot-dot line. 


The attribute can be assigned dynamic properties by means of the name TrendLineStyle. The 
data type is LONG. 
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TrendLineType property 


Trend type - TrendLineType 
Defines how to visualize a trend. 


The following settings are available: 


Value Description Explanation 

0 None Only the dots are displayed. 

1 Connect dots Visualizes a trend with linear interconnection of points. 

linearly 

2 Stepped Visualizes a stepped trend and its interconnected points. 

3 Values Can only be configured with OnlineTrendControl. 
A value is displayed at each time stamp or at the main grid line of the time axis instead of 
trend points. 


The attribute can be assigned dynamic properties by means of the name TrendLineType. The 
data type is LONG. 


TrendLineWidth property 


Line weight - TrendLineWidth 
Defines the line weight of the line displayed. 


The attribute can be assigned dynamic properties by means of the name TrendLineWidth. The 
data type is LONG. 


TrendLowerLimit property 


TrendLowerLimit 


Specifies the low limit of a tag. The values are identified based on the color set in 
"TrendLowerLimitColor" if the tag value is less than "TrendLowerLimit". This setting is only 
active if the value at attribute "TrendLowerLimitColoring"” is "TRUE". 


The attribute can be assigned dynamic properties by means of the name TrendLowerLimit. 
The data type is DOUBLE. 


TrendLowerLimitColor property 


TrendLowerLimitColor 


Specifies the color of tag values which are less than the value at "TrendLowerLimit". This 
setting is only active if the value at attribute "TrendLowerLimitColoring" is "TRUE". 


The attribute can be assigned dynamic properties by means of the name 
TrendLowerLimitColor. The data type is LONG. 
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TrendLowerLimitColoring property 


TrendLowerLimitColoring 


Enables the "TrendLowerLimitColor" attribute for identifying tag values which are less than the 
value at "TrendLowerLimitValue". 


Value Explanation 
TRUE Attribute "TrendLowerLimitColor" is active. 
FALSE Attribute "TrendLowerLimitColor" is inactive. 


The attribute can be assigned dynamic properties by means of the name 
TrendLowerLimitColoring. The data type is BOOLEAN. 


TrendMeasure - TrendVisible 


TrendMeasurePoints property 


Number of measurement points - TrendMeasurePoints 
Defines the number of measurement points for visualization of selected trends. 
Defines the number of value pairs provided to the trend from a user archive. 


The attribute can be assigned dynamic properties by means of the name 
TrendMeasurePoints. The data type is LONG. 


TrendName property 


Object name - TrendName 
Displays the name of the selected trend. The name is defined on the "Trends" tab. 


The "TrendName" attribute can be assigned dynamic properties by means of attribute 
TrendRename. The data type is STRING. 


TrendPointColor property 


Point color - TrendPointColor 
Defines the color of trend points. Open the "Color selection" dialog by clicking the button. 


The configuration is only possible if the "Advanced" option is activated or 
"TrendExtendedColorSet" is "TRUE". 


The attribute can be assigned dynamic properties by means of the name TrendPointColor. 
The data type is LONG. 
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TrendPointStyle property 


Dot type - TrendPointStyle 


Defines the dot style for trend visualization. 


The following settings are available: 


Description Explanation 

0 None The points are not displayed. 

1 Dots The trend points are visualized with a size of one pixel. The setting 
in the "Dot width" field is deactivated. 

2 Squares The dots are displayed as square. The setting in the "Dot width" 
field is active. 

3 Circles The dots are displayed as circles. The setting in the "Dot width" field 
is active. 


The attribute can be assigned dynamic properties by means of the name TrendPointStyle. The 
data type is LONG. 


TrendPointWidth property 


Dot width - TrendPointWidth 


Sets the dot width in pixels. You can only define the dot width for the "square" and "circular" 
type. 


The attribute can be assigned dynamic properties by means of the name TrendPointWidth. 
The data type is LONG. 


TrendProvider property 
Data source - TrendProvider 


Specifies the data source for a selected trend. 


The following settings are available: 


Value Description Explanation 

0 None No data source configured for implementation in Runtime by means of script. 
1 Archive tags Data source with archive tags of a process value archive. 

2 Online tags Data source with online tags derived from tag management. 

3 User archive Data source with columns of a user archive. 


The attribute can be assigned dynamic properties by means of the name TrendProvider. The 
data type is LONG. 
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TrendProviderCLSID_FunctionTrend property 


TrendProviderCLSID_FunctionTrend 


Indicates the data source of the trend selected. 


Value Explanation 

No data source configured for implementation in Runtime by means of script. 
{416A09D2-8B5A-11D2- Data source with archive tags of a process value archive. 
8B81-006097A45D48} 
{A3F69593-8AB0-1 1D2- Data source with online tags derived from tag management. 
A440-00AO0C9DBB64E} 
{2DC9B1C8-4FC1-41B1- Data source with columns of a user archive. 


B354-3E469A13FBFD} 


The attribute can be assigned dynamic properties by means of the name 
TrendProviderCLSID. The data type is STRING. 


TrendProviderCLSID_OnlineTrend property 


TrendProviderCLSID_OnlineTrend 


Indicates the data source of the trend selected. 


Value Explanation 

No data source configured for implementation in Runtime by means of script. 
{416A09D2-8B5A-1 1D2- Data source with archive tags of a process value archive. 
8B81-006097A45D48} 
{A3F69593-8AB0-1 1D2- Data source with online tags derived from tag management. 


A440-00A0C9DBB64E} 


The attribute can be assigned dynamic properties by means of the name 
TrendProviderCLSID. The data type is STRING. 


TrendRangeType property 


Time range setting - TrendRangeType 
Defines the time range for providing data to the selected trend. 


You can only define the number of measuring points if you select user archives as the data 
source. 
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The following configuration options are available: 


Description Explanation 
0 Time range Defines the start time and the time range for the data connec- 
tion. 
Start to end time Defines the start and end time for the data connection. 
2 Number of measurement Defines the start time and the number of measurement points 
points for the data connection. 


The attribute can be assigned dynamic properties by means of the name TrendRangeType. 
The data type is LONG. 


TrendRemove property 


Remove - TrendRemove 
Removes selected trends from the list. 


The attribute can be assigned dynamic properties by means of the name TrendRemove. The 
data type is STRING. 


TrendRename property 


TrendRename 
Renames a trend which is referenced by means of "TrendIndex" attribute. 


The attribute can be assigned dynamic properties by means of the name TrendRename. 
"TrendRename" also sets a dynamic attribute "TrendName". The data type is STRING. 


TrendRepos property 


Up/Down - TrendRepos 


Repositions the trend in the trend window. "Up" and "Down" move the selected trend up or 
down in the list. This moves the trend towards the foreground or background for visualization 
in Runtime. 


The attribute can be assigned dynamic properties by means of the name TrendRepos. The 
data type is LONG. 


TrendSelectTagName property 


TrendSelectTagName 


Opens a dialog for selecting the tag name for the source of Y axis data in WinCC 
OnlineTrendControl. Programmers can set this attribute to allow users to select a tag name 
by means of a button, for example. 
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The attribute can be assigned dynamic properties by means of the name 
TrendSelectTagName. The data type is BOOLEAN. 


TrendSelectTagNamexX property 


TrendSelectTagNameX 


Opens a dialog for selecting the tag name for the source of X axis data in WinCC 
FunctionTrendControl. Programmers can set this attribute to allow users to select a tag name 
by means of a button, for example. 


The attribute can be assigned dynamic properties by means of the name 
TrendSelectTagNamex. The data type is BOOLEAN. 


TrendSelectTagNameY property 


TrendSelectTagNameY 


Opens a dialog for selecting the tag name for the source of Y axis data in WinCC 
FunctionTrendControl. Programmers can set this attribute to allow users to select a tag name 
by means of a button, for example. 


The attribute can be assigned dynamic properties by means of the name 
TrendSelectTagNameY. The data type is BOOLEAN. 


TrendShowAlarms property 


Displaying alarms - TrendShowAlarms 


If you have connected online tags and activate the "Show alarms" option, you can have the 
assigned message displayed as a symbol and tooltip for the trend values with limit violation. 
Limit monitoring must be configured in the alarm logging for the online tag for this. 


The red symbol indicates a high or low limit violation. The tooltip contains the message text 
and information text of the message. If you have configured "Loop in Alarm" with the 
"OpenPicture" function for the message, you can jump to the assigned picture by double- 
clicking this symbol. 


The attribute can be assigned dynamic properties by means of the name TrendShowAlarms. 
The data type is BOOLEAN. 


TrendState property 
TrendState 


Shows the status of the data link of the selected curve in Runtime. 


The attribute can be made dynamic with the name TrendState. The data type is LONG. 
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TrendTagName property 


Tag name - TrendTagName 


Displays the name of connected tags. Use the Open button to open a dialog for selecting an 
online or archive tag. 


The attribute can be assigned dynamic properties by means of the name TrendTagName. The 
data type is STRING. 


TrendTagNamexX property 


Tag Name X / Column X - TrendTagNameX 


Shows the name of interconnected tags or of the column for the X axis. Using the selection 
button, select a tag or a column for the data source you configured. 


The attribute can be assigned dynamic properties by means of the name TrendTagNameX. 
The data type is STRING. 


TrendTagNameY property 


Tag Name Y / Column Y - TrendTagNameY 


Shows the name of interconnected tags or of the column for the Y axis. Using the selection 
button, select a tag or a column for the data source you configured. 


The attribute can be assigned dynamic properties by means of the name TrendTagNameY. 
The data type is STRING. 


TrendTimeAxis property 


Time axis - TrendTimeAxis 


Defines the time axis to be used for the trend selected. Define the available time axes in the 
"Time axes" tab. 


The attribute can be assigned dynamic properties by means of the name TrendTimeAxis. The 
data type is STRING. 


TrendTimeRangeBase property 


Time Range - TrendTimeRangeBase 
Defines the time unit for calculating the time range. 
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The following time units are available: 


Value Description 
500 500 ms 
1000 1 second 
60000 1 minute 
3600000 1 hour 
86400000 1 day 


The attribute can be assigned dynamic properties by means of the name 
TrendTimeRangeBase. The data type is LONG. 


TrendTimeRangeFactor property 


Time range - TrendTimeRangeFactor 


Defines the factor for calculating the time range. Only integer factors are valid. 


The attribute can be assigned dynamic properties by means of the name 
TrendTimeRangeFactor. The data type is SHORT. 


TrendTrendWindow property 


Trend window - TrendTrendWindow 


Defines the trend window for visualizing the trend selected. Define the available trend windows 
in the "Trend window" tab. 


The attribute can be assigned dynamic properties by means of the name 
TrendTrendWindow. The data type is STRING. 


TrendUncertainColor property 


TrendUncertainColor 


Value are in uncertain state if the initial value is unknown after runtime has been activated, or 
if a substitute value is used. Set attribute "TrendUncertainColor" to define the color identifier 
of these values. The "TrendUncertainColoring" attribute determines whether or not this setting 
is evaluated. 


The attribute can be assigned dynamic properties by means of the name 
TrendUncertainColor. The data type is LONG. 
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TrendUncertainColoring property 


TrendUncertainColoring 


Value are in uncertain state if the initial value is unknown after runtime has been activated, or 
if a substitute value is used. The "TrendUncertainColoring" attribute is used to enable 
identification of such values based on the color set in "TrendUncertainColor". 


Explanation 
TRUE The settings of the "TrendUncertainColor" attribute are active. 
FALSE The settings of the "TrendUncertainColor" attribute are inactive. 


The attribute can be assigned dynamic properties by means of the name 
TrendUncertainColoring. The data type is BOOLEAN. 


TrendUpperLimit property 


TrendUpperLimit 


Specifies the high limit of a tag. The values are identified based on the color set in 
"TrendUpperLimitColor" if the tag value exceeds the "TrendUpperLimit". This setting is only 
active if the value at attribute "TrendUpperLimitColoring" is "TRUE". 


The attribute can be assigned dynamic properties by means of the name TrendUpperLimit. 
The data type is DOUBLE. 


TrendUpperLimitColor property 


TrendUpperLimitColor 


Specifies the color of tag values which are less than the value at "TrendLowerLimit". This 
setting is only active if the value at attribute "TrendUpperLimitColoring" is "TRUE". 


The attribute can be assigned dynamic properties by means of the name 
TrendUpperLimitColor. The data type is LONG. 


TrendUpperLimitColoring property 


TrendUpperLimitColoring 


Enables the "TrendUpperLimitColor" attribute for identifying tag values which are less than the 
value at "TrendUpperLimit". 


Value Explanation 


TRUE The setting of the "TrendUpperLimitColor" attribute is active. 
FALSE The setting of the "TrendUpperLimitColor" attribute is inactive. 
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The attribute can be assigned dynamic properties by means of the name 
TrendUpperLimitColoring. The data type is BOOLEAN. 


TrendValueAlignment property 


Alignment - TrendValueAlignment 
Specifies the alignment of the displayed values for the trend type "Values". 
The following settings are available depending on the writing direction of the trend: 


e The writing direction of the trend is "from right" or "from left" 


Value Description Explanation 

0 Bottom The values are displayed at the bottom in the trend window. 
1 Centered The values are displayed centered in the trend window. 

2 Top The values are displayed at the top in the trend window. 


e The writing direction of the trend is "from top" or "from bottom" 


Value Description Explanation 

0 Left The values are displayed on the left in the trend window. 
1 Centered The values are displayed centered in the trend window. 

2 Right The values are displayed on the right in the trend window. 


The attribute can be assigned dynamic properties by means of the name 
TrendValueAlignment. The data type is LONG. 


TrendValueAxis property 


Value axis - TrendValueAxis 


Defines the value axis to be used for the trend selected. Define the available value axes in the 
"Value axes" tab. 


The attribute can be assigned dynamic properties by means of the name TrendValueAxis. The 
data type is STRING. 


TrendValueUnit property 


Unit - TrendValueUnit 


Specifies a unit for the trend type "Values" that is appended to the displayed value, e.g., "%" 
or a Goa 


The attribute can be assigned dynamic properties by means of the name TrendValueUnit. The 
data type is STRING. 
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TrendVisible property 


Trends - TrendVisible 


The list shows all trends you created. 
Select the trends to be displayed in the trend window from the list. 


Click a trend entry in the list to adapt the properties and to assign axes and trend windows to 
the trend. 


The attribute can be assigned dynamic properties by means of the name TrendVisible. The 
data type is BOOLEAN. 


TrendWindow - TrendYAxis 


TrendWindowAdd property 


New - TrendWindowAdd 


Creates a new trend window. 


The attribute can be assigned dynamic properties by means of the name TrendWindowAdd. 
The data type is STRING. 


TrendWindowCoarseGrid property 


Main grid lines - TrendWindowCoarseGrid 


Enables the display of grid lines for the main scale. 


Value Explanation 
TRUE Enables the display of grid lines for the main scale. 
FALSE Disables the display of grid lines for the main scale. 


The attribute can be assigned dynamic properties by means of the name 
TrendWindowCoarseGrid. The data type is BOOLEAN. 


TrendWindowCoarseGridColor property 


Color of main scale - TrendWindowCoarseGridColor 


660 


Specifies the grid color of the main scale. Open the "Color selection" dialog by clicking the 
button. 


The attribute can be assigned dynamic properties by means of the name 
TrendWindowCoarseGridColor. The data type is LONG. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


VBS for Creating Procedures and Actions 
7.14 VBS Reference 


TrendWindowCount property 


TrendWindowCount 
Defines the number of configured trend views. 


The attribute can be assigned dynamic properties by means of the name 
TrendWindowCount. The data type is LONG. 


TrendWindowFineGrid property 


Secondary grid lines - TrendWindowFineGrid 


Enables the display of grid lines for the secondary scale. 


Value Explanation 
TRUE Enables the display of grid lines for the secondary scale. 
FALSE Disables the display of grid lines for the secondary scale. 


The attribute can be assigned dynamic properties by means of the name 
TrendWindowFineGrid. The data type is BOOLEAN. 


TrendWindowFineGridColor property 


Color of secondary scale - TrendWindowFineGridColor 


Specifies the grid color of the main scale. Open the "Color selection" dialog by clicking the 
button. 


The attribute can be assigned dynamic properties by means of the name 
TrendWindowFineGridColor. The data type is LONG. 


TrendWindowForegroundTrendGrid property 


Only for foreground trend - TrendWindowForegroundTrendGrid 


Enables the display of grid lines only for the foreground trend in the trend window. 


Value Explanation 
TRUE Enables the display of grid lines for the foreground trend in the trend window. 
FALSE Enables the display of grid lines for all trends in the trend window. 


The attribute can be assigned dynamic properties by means of the name 
TrendWindowForegroundTrendGrid. The data type is BOOLEAN. 
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TrendWindowGridInTrendColor property 


Use trend color - TrendWindowGridInTrendColor 


Sets the trend color for the visualization of the grid lines for the main scale. 


Value Explanation 
TRUE The grid is displayed in the trend color. 
FALSE The grid is displayed with the color set in the "Color" field. 


The attribute can be assigned dynamic properties by means of the name 
TrendWindowGridInTrendColor. The data type is BOOLEAN. 


TrendWindowHorizontalGrid property 


For X axis - TrendWindowVerticalGrid 


Enables the display of horizontal grid lines. 


Value Explanation 
TRUE The display of horizontal grid lines is enabled. 
FALSE The display of horizontal grid lines is disabled. 
The attribute can be assigned dynamic properties by means of the name 
TrendWindowHorizontalGrid. The data type is BOOLEAN. 
TrendWindowlndex property 


TrendWindowlIndex 


References a configured trend view. Using this attribute you can assign the values of other 
attributes to a specific trend view. 


Values between 0 and "TrendWindowlIndex" minus 1 are valid for "TrendWindowCount". 
Attribute "TrendWindowCount" defines the number of trend views configured. 


The "TrendWindowIndex" attribute can be assigned dynamic properties by means of attribute 
TrendWindowRepos. The data type is LONG. 


TrendWindowName property 


Object name - TrendWindowName 
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Defines the name of the trend window selected. 


The "TrendWindowName" attribute can be assigned dynamic properties by means of attribute 
TrendWindowRename. The data type is STRING. 
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TrendWindowRemove property 


Remove - TrendWindowRemove 
Removes the selected trend window from the list. 


The attribute can be assigned dynamic properties by means of the name 
TrendWindowRemove. The data type is STRING. 


TrendWindowRename property 


TrendWindowRename 
Renames a trend view which is referenced by means of "TrendWindowlndex" attribute. 


The attribute can be assigned dynamic properties by means of the name 
TrendWIindowRename. "TrendWindowRename" also sets a dynamic attribute 
"TrendWindowName". The data type is STRING. 


TrendWindowRepos property 


Up/Down - TrendWindowRepos 


Changes the sorting order of the trend windows. "Up" and "Down" move the selected trend up 
or down in the list. 


The sorting order in the list defines the position in the Control. The first trend window is 
displayed at the last position, while the last is displayed at the top position. 


The attribute can be assigned dynamic properties by means of the name 
TrendWindowRepos. The data type is LONG. 


TrendWindowRulerColor property 


Ruler color - TrendWindowRulerColor 
Specifies the ruler color. Open the "Color selection" dialog by clicking the button. 


The color can be configured and displayed if "1 - graphic" is set for display of the ruler or 
"TrendWindowRulerStyle". 


The attribute can be assigned dynamic properties by means of the name 
TrendWindowRulerColor. The data type is LONG. 


TrendWindowRulerLayer property 


Ruler layer - TrendWindowRulerLayer 


Defines the representation layer of a ruler in the trend window. 
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The following settings are available: 


Description Explanation 

0 Under grid The ruler is visualized on a layer under the grid. 

1 Between grid and The ruler is positioned on top of the trend and under the grid. 
trend 

2 On top of trend The ruler is positioned on top of the trend. 


The attribute can be assigned dynamic properties by means of the name 
TrendWindowRulerLayer. The data type is LONG. 


TrendWindowRulerStyle property 
Ruler - TrendWindowRulerStyle 


Defines the appearance of the ruler. 


The following settings are available: 


Value Description Explanation 
0 Simple The ruler is displayed as basic black line. 
1 Graphic The ruler is displayed based on the "color" and "weight" configured. 


The attribute can be assigned dynamic properties by means of the name 
TrendWindowRulerStyle. The data type is LONG. 


TrendWindowRulerWidth property 


Ruler width - TrendWindowRulerWidth 
Defines the width of the ruler in pixels. 


The width can be configured and displayed if "1 - graphic" is set for display of the ruler or 
"TrendWindowRulerStyle". 


The attribute can be assigned dynamic properties by means of the name 
TrendWindowRulerWidth. The data type is LONG. 


TrendWindowSpacePortion property 


Proportional area - TrendWindowSpacePortion 
Specifies the proportion of the trend widow to be used for the selected curve. 


The attribute can be assigned dynamic properties by means of the name 
TrendWindowSpacePortion. The data type is LONG. 
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TrendWindowStatisticRulerColor property 


Color of ruler for statistics area - TrendWindowStatisticRulerColor 


Specifies the color of the ruler for the statistics area. The button opens the "Color selection" 
dialog to select the color. 


The color can be configured and displayed if "1 - graphic" is set for display of the ruler for the 
statistics area or "TrendWindowStatisticRulerStyle". 


The attribute can be assigned dynamic properties by means of the name 
TrendWindowStatisticRulerColor. The data type is LONG. 


TrendWindowStatisticRulerStyle property 
Ruler for statistics area - TrendWindowStatisticRulerStyle 


Enables the display of a ruler for defining the statistics area. 


The following settings are available: 


Value Description Explanation 
0 Simple The ruler is displayed as basic black line. 
1 Graphic The ruler is displayed based on the "color" and "weight" configured. 


The attribute can be assigned dynamic properties by means of the name 
TrendWindowStatisticRulerStyle. The data type is LONG. 


TrendWindowStatisticRulerWidth property 


Width of ruler for statistics area - TrendWindowStatisticRulerWidth 
Defines the width of the ruler for the statistics area in pixels. 


The width of the ruler can be configured and displayed if "1 - graphic" is set for display of the 
ruler for the statistics area or "TrendWindowStatisticRulerStyle". 


The attribute can be assigned dynamic properties by means of the name 
TrendWindowStatisticRulerWidth. The data type is LONG. 


TrendWindowVerticalGrid property 


for Y axis - TrendWindowVerticalGrid 


Enables the display of vertical grid lines. 


Value Explanation 
TRUE The display of vertical grid lines is enabled. 
FALSE The display of vertical grid lines is disabled. 
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The attribute can be assigned dynamic properties by means of the name 
TrendWindowVerticalGrid. The data type is BOOLEAN. 


TrendWindowvVisible property 


Trend window - TimeAxis TrendWindow 
The list shows all trend windows you created. 
Select the trend windows to be displayed in the control from the list. 
Click a list entry to adapt the ruler and grid line properties. 


The attribute can be assigned dynamic properties by means of the name 
TrendWindowvisible. The data type is BOOLEAN. 


TrendXAxis property 


X axis - TrendXAxis 


Defines the X axis to be used for the trend selected. Define the available X axes inn the "X 
Axes" tab. 


The attribute can be assigned dynamic properties by means of the name TrendXAxis. The 
data type is STRING. 


TrendYAxis property 


Y axis - TrendYAxis 


Defines the Y axis to be used for the trend selected. Define the available Y axes inn the "Y 
Axes" tab. 


The attribute can be assigned dynamic properties by means of the name TrendYAxis. The 
data type is STRING. 


Type 


Type Property 


Description 
Reads out the object type, e.g. "Rectangle", "Circle" or "Line". 
The object type is returned as a string. Read only 


A special ID is returned as the type for all the graphic elements provided by WinCC. It can be 
found under the topic "Type Identification in VBS“ in the individual descriptions of the WinCC 
Object Types. 
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Special feature 
In the case of non-WinCC controls and OLE objects, the version-independent ProgID is 
returned as the type. 


It is possible to determine the version-dependent ProgID or "User friendly Name" from the 


ProgID: In the following example, "Control1" is a control embedded in the picture which already 


returns the version-independent ProgID as a result of the Type property. 


Note 


Since not every Control has a version-dependent ProgID, an error handling measure should 
be integrated to query the version-dependent ProgID or UserFriendlyName. If no error handling 


is used, the code is terminated immediately without any result when no ProgID is found. 


Determine the version-dependent ProgID as follows: 


"VBS91 

Dim objControl 

Dim strCurrentVersion 

Set objControl = ScreenItems ("Controll") 

strCurrentVersion = CreateObject ("WScript.Shell") .RegRead("HKCR\" & objControl.Type & 
"\CurVer\") 

MsgBox strCurrentVersion 


Note 
In order that example above works, a multimedia control should be inserted in the picture. 


Determine the User Friendly Name as follows: 


"VBS 92 

Dim objControl 

Dim strFriendlyName 

Set objControl = ScreenItems ("Controlli") 

strFriendlyName = CreateObject ("WScript.Shell") .RegRead("HKCR\" & objControl.Type & "\") 


MsgBox strFriendlyName 


Note 


In order that example above works, a multimedia control should be inserted in the picture. 
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Example: 


The following example displays the type for all objects in the picture "NewPDL1": 


"VBS 93 

Dim objScreen 

Dim objScriItem 

Dim IngIndex 

Dim lngAnswer 

Dim strName 

IngIndex = 1 

Set objScreen = HMITRuntime.Screens ("NewPDL1") 
For IngIndex = 1 To objScreen.ScreenItems.Count 
strName = objScreen.ScreenItems (lngIndex) .ObjectNam 
Set objScrItem = objScreen.ScreenItems (strName) 
IngAnswer = MsgBox (objScritem.Type, vbOKCancel) 
If vbCancel = lngAnswer Then Exit For 

Next 


See also 
Screenltem Object (Page 125) 
Object types of the Screenltem object (Page 143) 


TypeAlarmHigh Property 


Description 
TRUE, when the upper limit value, at which an alarm is triggered, should be evaluated as a 
percentage. FALSE, when the evaluation should be as an absolute value. BOOLEAN write- 
read access. 

See also 
Screenltem Object (Page 125) 
Bar (Page 174) 

TypeAlarmLow Property 

Description 


TRUE, when the lower limit value, at which an alarm is triggered, should be evaluated as a 
percentage. FALSE, when the evaluation should be as an absolute value. BOOLEAN write- 
read access. 
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See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
TypeLimitHigh4 Property 
Description 
TRUE, when the "Reserve 4" upper limit value should be evaluated as a percentage. FALSE, 
when the evaluation should be as an absolute value. BOOLEAN write-read access. 
See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
TypeLimitHigh5 Property 
Description 
TRUE, when the "Reserve 5" upper limit value should be evaluated as a percentage. FALSE, 
when the evaluation should be as an absolute value. BOOLEAN write-read access. 
See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
TypeLimitLow4 Property 
Description 
TRUE, when the "Reserve 4" lower limit value should be evaluated as a percentage. FALSE, 
when the evaluation should be as an absolute value. BOOLEAN write-read access. 
See also 


Bar (Page 174) 
Screenltem Object (Page 125) 
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TypeLimitLow5 Property 


Description 


TRUE, when the "Reserve 5" lower limit value should be evaluated as a percentage. FALSE, 
when the evaluation should be as an absolute value. BOOLEAN write-read access. 


See also 
Bar (Page 174) 
Screenltem Object (Page 125) 


TypeToleranceHigh Property 


Description 


TRUE, when the "Tolerance high" lower limit value should be evaluated as a percentage. 
FALSE, when the evaluation should be as an absolute value. BOOLEAN write-read access. 


See also 
Bar (Page 174) 
Screenltem Object (Page 125) 


TypeToleranceLow Property 


Description 
TRUE, when the "Tolerance low" lower limit value should be evaluated as a percentage. 
FALSE, when the evaluation should be as an absolute value. BOOLEAN write-read access. 
See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
TypeWarningHigh Property 
Description 


TRUE, when the "Warning high" lower limit value should be evaluated as a percentage. FALSE, 
when the evaluation should be as an absolute value. BOOLEAN write-read access. 
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See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
TypeWarningLow Property 
Description 
TRUE, when the "Warning low" lower limit value should be evaluated as a percentage. FALSE, 
when the evaluation should be as an absolute value. BOOLEAN write-read access. 
See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
1.14.4.20 U 
Un - Up 
UnitColor Property 
Description 
Defines the text color for the names of the unit of measurement. LONG write-read access. 
See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 
UnitFont Property 
Description 


Controls the display of the labeling for the unit of measurement. Read only access. 
The following properties can be set: 

- Font 

- Font Style 


- Font Size 
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- "Strikethrough" effect 


- "Underline" effect 


See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 
UnitOffset Property 
Description 
This attribute defines the distance of the text for the unit of measurement in relation to the top 
edge of the object. The text can only be positioned along the vertical diameter of the graduated 
scale disk. The value of the property is related to the height of the object and is measured from 
the top edge of the object to the base of the text. 
The value range is 0 is 1. 
0: The base of the text is at the top limit of the object. The text is no longer visible because it 
is outside the object. 
1: The base of the text is at the bottom limit of the object. 
See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 
UnitText Property 
Description 
Defines the text for the unit of measurement. Write/Read access. 
See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 
UnselBGColor Property 
Description 


Defines or returns the background color of entries in the text list object which are not selected. 
LONG write-read access. 
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See also 
Text list (Page 196) 
Screenltem Object (Page 125) 
UnselTextColor Property 
Description 
Defines or returns the color of the text for entries in the text list object which are not selected. 
LONG write-read access. 
See also 
Text list (Page 196) 
Screenltem Object (Page 125) 
UpdateCycle Property 
Description 
Returns the type and frequency of updating the picture window in Runtime. Read only access. 
See also 
Picture Window (Page 179) 
Screenltem Object (Page 125) 
UpperLimit Property 
Description 
TRUE, when the "UpperLimitColor" specification is to be used in order to identify the tag values 
(from a trend referenced via "Index") which lie above the value defined in "UpperLimitValue". 
BOOLEAN write-read access. 
See also 


WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 
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UpperLimitColor Property 


Description 


See also 


Defines the color to be used in order to identify the tag values (from a trend referenced via 
"Index") which lie above the value defined in "UpperLimitValue". Whether the information is 
evaluated is dependent on the value of the "UpperLimit" property. The color is defined as an 
RGB value. LONG write-read access. 


WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
Screenltem Object (Page 125) 


UpperLimitTagName Property 


Description 
This defines the upper limit of the trend range, which is automatically taken from the variable 
properties configured in PCS 7. Write/Read access. 
UpperLimitValue Property 
Description 
Tag values (from a trend referenced via "Index") which lie above the value defined by 
"UpperLimitValue" are identified by the color specified in "UpperLimitColor". Whether the 
information is evaluated is dependent on the value of the "UpperLimit" property. 
See also 
Screenltem Object (Page 125) 
WinCC Online Table Control (before WinCC V7) (Page 292) 
WinCC Online Trend Control (before WinCC V7) (Page 295) 
WinCC Function Trend Control (before WinCC V7) (Page 288) 
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Us 
UseColumnBackColor property 


Use column color / background - UseColumnBackColor 
Specifies the settings to be activated for the background colors of columns. 


Value Explanation 

TRUE The background color settings are active in the "Time columns" or "TimeColumnBackColor" tabs and in the 
"Value columns" or "ValueColumnBackColor" tabs. 

FALSE The background color settings are active in the "Display" tab. 


The attribute can be assigned dynamic properties by means of the name 
UseColumnBackColors. The data type is BOOLEAN. 


UseColumnForeColor property 


Use column color / font - UseColumnForeColor 
Defines the active font color settings for the columns. 


Value Explanation 

TRUE The font color color settings are active in the "Time columns" or "TimeColumnForeColor" tabs and in the "Value 
columns" or "ValueColumnForeColor" tabs. 

FALSE The font color settings are active in the "Display" tab. 


The attribute can be assigned dynamic properties by means of the name 
UseColumnForeColors. The data type is BOOLEAN. 


UseMessageColor property 


Show message colors - UseMessageColor 
Sets the outputs of messages with colors as agreed by handshake. 


Value Explanation 

TRUE The message colors are displayed. 

FALSE The message colors are not displayed. Instead, the color settings defined for the table content are activated 
on the "Display" tab. 


The attribute can be assigned dynamic properties by means of the name UseMessageColor. 
The data type is BOOLEAN. 
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UseOnlineTags Property 


Description 


This defines whether or not the variable properties configured in PCS 7 are applied as trend 
parameters. Write/Read access. 


UseRangeSubstitutes Property 


Description 


TRUE, if a separate scaling of the value axis is displayed for the trends in Trend Control. 
BOOLEAN write-read access. 


UserData-Property 


Description 


Contains the value that is to be transferred to the VB script while running a customized menu 
item or icon. STRING (write-read access) 


Example: 


Use the "User data" field in the "Menus and Toolbars" editor to apply a parameter to the 
procedure 


The following example shows the "ActivateScreen" procedure that executes the picture 
change. Enter the picture name in the "User Data" field: 


Sub ActivateScreen (ByVal Item) 

Dim objScreen 

Dim strScreenName 

' "UserData" contains the screen name specified 
" in editor menus and toolbars. 


strScreenName = Item.Userdata 
HMTRuntime.BaseScreenName = strScreenName 
End Sub 

UserName property 

Description 


Returns the name of the user who triggered the alarm object. 
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Alarms object (list) (Page 110) 


UserValue1 Property 


Description 


See also 


Defines or returns a value. 
The value can be evaluated by a script, for example. This value is neither evaluated nor 
displayed in Runtime. 


Screenltem Object (Page 125) 
Group Display (Page 194) 


UserValue2-Eigenschaft 


Description 
Defines or returns a value. 
The value can be evaluated by a script, for example. This value is neither evaluated nor 
displayed in Runtime. 
See also 
Group Display (Page 194) 
Screenltem Object (Page 125) 
UserValue3 Property 
Description 
Defines or returns a value. 
The value can be evaluated by a script, for example. This value is neither evaluated nor 
displayed in Runtime. 
See also 


Group Display (Page 194) 
Screenltem Object (Page 125) 
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UserValue4 Property 


Description 


Defines or returns a value. 
The value can be evaluated by a script, for example. This value is neither evaluated nor 


displayed in Runtime. 
See also 


Group Display (Page 194) 
Screenltem Object (Page 125) 


UseSelectedTitleColor property 


Selection color - UseSelectedTitleColor 
Specifies whether to use a selection color for the headers of selected table cells. 


Value Explanation 

TRUE A selection color is used. The "Background" or "SelectedTitleColor" and "Font" or "SelectedTitleForeColor" 
settings are active in Runtime. 

FALSE Selection color is not used. The "Background" and "Font" settings are disabled in Runtime. 


The attribute can be assigned dynamic properties by means of the name 
UseSelectedTitleColor. The data type is BOOLEAN. 


UseSourceBackColors property 


Apply background colors - UseSourceBackColors 
Sets the background color derived from the control defined in the "Source" field. 


Value Explanation 
TRUE The background color from the interconnected control is used. 
FALSE The background color from the interconnected control is not used. The settings on the "Layout" tab are used. 


The attribute can be assigned dynamic properties by means of the name 
UseSourceBackColors. The data type is BOOLEAN. 
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UseSourceForeColors property 


Apply font colors - UseSourceForeColors 


Sets the font colors derived from the control defined in the "Source" field. 


Value Explanation 
TRUE The font color of the interconnected control is activated. 
FALSE The font color from the connected control is not used. The settings on the "Layout" tab are used. 


The attribute can be assigned dynamic properties by means of the name 
UseSourceForeColors. The data type is BOOLEAN. 


UseTableColor2 property 


Row Color 2 - UseTableColor2 


Specifies whether to use a second row color for the representation of the table. 


Value Explanation 
TRUE "Row color 2" and "Row color 1" are used alternately. 
FALSE The "Row color 1" settings are used for all rows. 


The attribute can be assigned dynamic properties by means of the name UseTableColor2. 
The data type is BOOLEAN. 


UseTrendNameAsLabel property 


UseTrendNameAsLabel 


Sets the "TrendName" or "TrendLabel" attribute for labeling the trend in Runtime. 


Value Explanation 
TRUE Sets the "TrendName" attribute for labeling the trend in Runtime. 
FALSE Sets the "TrendLabel" attribute for labeling the trend in Runtime. 


The attribute can be assigned dynamic properties by means of the name 
UseTrendNameAsLabel. The data type is BOOLEAN. 
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1.14.4.21 V 
Val - ValueAxis 
Value Property 


Description of Tag Object 
Displays the value of the tags at the last read access or the value written or to be written. Value 
represents the value of a tag. After calling in the "Read" method, the tag value read is returned. 
Before writing, the new tag value required can be assigned to the property. After calling in the 
"Write" method, the property contains the value last written. 


VARIANT (write-read access) 


Example: 
The following example writes a new value in the "Tag1" tag: 


"VBS94 

Dim objTag 

Set objTag = HMIRuntime.Tags ("Tagl") 
objTag.Value = 50 

objTag.Write 


Description of WinCC Gauge Control 
Defines the value to which the pointer points. Value Range: "ValueMin" to "ValueMax". 


Description of Dataltem Object 
Returns a value copy or object reference. Furthermore, an already added value can be 
changed via the value property. 
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Example: 
The example shows how to add a value to the list, and how to output it as a trace. After that, 
the value is changed, output again and then removed. It make sense to perform this in several 
different actions. 

"'VBS198 

HMTRuntime.DataSet.Add "motor1", 23 

HMIRuntime.Trace "motorl: " & HMIRuntime.DataSet ("motorl") .Value & vbNewLine 

HMIRuntime.DataSet ("motorl") .Value = 55 

HMIRuntime.Trace "motorl: " & HMIRuntime.DataSet ("motorl1") .Value & vbNewLine 


HMIRuntime.DataSet.Remove ("motor1") 


Note 


For object references it must be ascertained that objects are multiread-enabled. 


See also 
WinCC Gauge Control (Page 254) 
Write Method (Page 813) 
Read Method (Page 783) 
Tag Object (Page 137) 
Dataltem Object (Page 113) 
ProcessValues Object (List) (Page 124) 


ValueAxisAdd property 
New - ValueAxisAdd 


Creates a new value axis. 


The attribute can be assigned dynamic properties by means of the name ValueAxisAdd. The 
data type is STRING. 


ValueAxisAlign property 


Alignment - ValueAxisAlign 
Specifies the mode of alignment of a selected value axis. 
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Value 


The following settings are available: 


Description Explanation 


left The selected value axis is displayed on left side of the trend or diagram. 


right The selected value axis is displayed on right side of the trend or diagram. 


The attribute can be assigned dynamic properties by means of the name ValueAxisAlign. The 
data type is LONG. 


ValueAxisAutoPrecisions property 


Decimal places automatic - ValueAxisAutoPrecisions 


Enables automatic setting of the decimal precision. 


Value Explanation 

TRUE The decimal precision is defined automatically. The value in the "Decimal places" or "ValueAxisPreci- 
sions" field is disabled. 

FALSE The value in the "Decimal places" or "ValueAxisPrecisions" field is active. 


The attribute can be assigned dynamic properties by means of the name 
ValueAxisAutoPrecisions. The data type is BOOLEAN. 


ValueAxisAutoRange property 


Value range automatic - ValueAxisAutoRange 


Enables automatic calculation of the range of values. 


Value Explanation 
TRUE The range of values is calculated automatically. 
FALSE The range of values is calculated based on the values configured in the "from" and "to" or "ValueAxisBegin- 
Value" and "ValueAxisEndValue" fields. 
The attribute can be assigned dynamic properties by means of the name 
ValueAxisAutoRange. The data type is BOOLEAN. 
ValueAxisBarWindow property 


Diagram window - ValueAxisBarWindow 
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Specifies the diagram window in which the selected value axis will be used. You can specify 
the available diagram window in the "Diagram window" tab or using "BarWindowAdd". 


The attribute can be assigned dynamic properties using the name ValueAxisBarWindow. The 
data type is STRING. 
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ValueAxisBeginValue property 


Value range from - ValueAxisBeginValue 


Specifies the start value of the value axis selected. You can configure the value if the 
"Automatic" option is disabled or "ValueAxisAutoRange" is "FALSE". 


The attribute can be assigned dynamic properties by means of the name 
ValueAxisBeginValue. The data type is DOUBLE. 


ValueAxisColor property 


Value axis color - ValueAxisColor 
Specifies the color of the time axis. The button opens the "Color selection" dialog to select the 
color. 


The setting is only active if the "Use trend color" or "Use diagram color" option is disabled or 
if "ValueAxisInTrendColor" is "FALSE". 


The attribute can be assigned dynamic properties by means of the name ValueAxisColor. The 
data type is LONG. 


ValueAxisCount property 


ValueAxisCount 
Defines the number of value axes configured. 


The attribute can be assigned dynamic properties by means of the name ValueAxisCount. The 
data type is LONG. 


ValueAxisEndValue property 


Value range to - ValueAxisEndValue 
Specifies the end value of the value axis selected. You can configure the value if the 
"Automatic" option is disabled or "ValueAxisAutoRange" is "FALSE". 


The attribute can be assigned dynamic properties by means of the name 
ValueAxisEndValue. The data type is DOUBLE. 
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ValueAxisExponentialFormat property 


Exponential notation - ValueAxisExponentialFormat 


Sets exponential notation for the display of values of a value axis selected. 


Value Explanation 
TRUE The values are displayed with exponential notation. 
FALSE The values are displayed with decimal notation. 


The attribute can be assigned dynamic properties by means of the name 
ValueAxisExponentialFormat. The data type is BOOLEAN. 


ValueAxisInBarColor property 


In diagram color - ValueAxisInBarColor 


Specifies whether the selected value axis will be displayed in the diagram color. If there is 
more than one diagram in the diagram window, the color of the first diagram will be used. You 


specify the order of the diagrams on the "Diagrams" tab. 


Value Explanation 
TRUE The selected value axis is displayed in the diagram color. The setting in the "Color" or "ValueAxisColor" field 
is disabled. 
FALSE The value axis selected is displayed in the color set in the "Color" or "ValueAxisColor" field. 
The attribute can be assigned dynamic properties using the name ValueAxisInBarColor. The 
data type is BOOLEAN. 
ValueAxisIndex property 


ValueAxisIndex 
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References a value axis. Using this attribute you can assign the values of other attributes to 
a specific value axis. 

Values between 0 and "ValueAxisCount" minus 1 are valid for "ValueAxisIndex". Attribute 
"ValueAxisCount" defines the number of value axes configured. 

The "ValueAxisIndex" attribute can be assigned dynamic properties by means of attribute 
ValueAxisRepos. The data type is LONG. 
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ValueAxisInTrendColor property 


Use trend color - ValueAxisInTrendColor 


Sets the trend color for displaying the value axis selected. The color of the first trend is activated 
if several trends are displayed in the trend window. Define the order of trends on the "Trends" 


tab. 
Value Explanation 
TRUE The selected value axis is displayed in the trend color. The setting in the "Color" or "Val- 


ueAxisColor" field is disabled. 


FALSE The value axis selected is displayed in the color set in the "Color" or "ValueAxisColor" field. 


The attribute can be assigned dynamic properties by means of the name 
ValueAxisInTrendColor. The data type is BOOLEAN. 


ValueAxisInTrendColor property 


Use trend color - ValueAxisInTrendColor 


Sets the trend color for displaying the value axis selected. The color of the first trend is activated 
if several trends are displayed in the trend window. Define the order of trends on the "Trends" 


tab. 
Value Explanation 
TRUE The selected value axis is displayed in the trend color. The setting in the "Color" or "ValueAxisColor" field is 
disabled. 
FALSE The value axis selected is displayed in the color set in the "Color" or "ValueAxisColor" field. 


The attribute can be assigned dynamic properties by means of the name 
ValueAxisInTrendColor. The data type is BOOLEAN. 


ValueAxisLabel property 


Label - ValueAxisLabel 
Specifies the label of a value axis selected. 


The attribute can be assigned dynamic properties by means of the name ValueAxisLabel. The 
data type is STRING. 


ValueAxisName property 


Object name - ValueAxisName 


Specifies the name of a value axis selected. 
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The "ValueAxisName" attribute can be assigned dynamic properties by means of attribute 
ValueAxisRename. The data type is STRING. 


ValueAxisPrecisions property 


Decimal places - ValueAxisPrecisions 


Specifies the decimal precision for displaying the value axis selected. The value can be 
configured and is active in Runtime, if the "Automatic" option is disabled or 
"ValueAxisAutoPrecisions" is "FALSE". 


The attribute can be assigned dynamic properties by means of the name 
ValueAxisPrecisions. The data type is SHORT. 


ValueAxisRemove property 


Remove - ValueAxisRemove 
Removes the selected value axis from the list. 


The attribute can be assigned dynamic properties by means of the name ValueAxisRemove. 
The data type is STRING. 


ValueAxisRename property 


ValueAxisRename 
Renames a value axis which is referenced by means of "ValueAxisIndex" attribute. 


The attribute can be assigned dynamic properties by means of the name ValueAxisRename. 
"ValueAxisRename" also sets a dynamic attribute "ValueAxisName". The data type is STRING. 


ValueAxisRepos property 


Up/Down - ValueAxisRepos 


Changes the order of value axes. "Up" and "Down" move the value axis selected up or down 
in the list. 


The list order determines the value axis position in the trend window or diagram window in 
runtime. If the orientation is the same and the value axis of the list is further above, the value 
axis is shown at a more remote position of the curve or diagram. 


The attribute can be assigned dynamic properties by means of the name ValueAxisRepos . 
The data type is LONG. 
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ValueAxisScalingType property 


Scaling - ValueAxisScalingType 
Specifies the scaling mode for a selected value axis. 


The following settings are available: 


Value Description Explanation 

0 Linear Enables linear scaling of a value axis selected. 

1 Logarithmic Enables logarithmic scaling of a value axis selected. 

2 Logarithmically negated Enables scaling of a selected value value axis with logarithmic negation. 


The attribute can be assigned dynamic properties by means of the name 
ValueAxisScalingType. The data type is LONG. 


ValueAxisTrendWindow property 


Trend window - ValueAxisTrendWindow 


Specifies the trend window for displaying the value axis selected. Define the available trend 
windows in the "Trend window" tab. 


The attribute can be assigned dynamic properties by means of the name 
ValueAxis TrendWindow. The data type is STRING. 


ValueAxisVisible property 


Value axes - ValueAxisVisible 


The list shows all value axes you created. Click a value axis entry in the list to adapt the 
properties and to assign a trend window or diagram window to the value axis. 


Select the value axes in the list that you want to display in the trend windows or diagram 
windows. 


The attribute can be assigned dynamic properties by means of the name ValueAxisVisible . 
The data type is BOOLEAN. 


ValueColumn - Vi 


ValueColumnAdd property 


New - ValueColumnAdd 


Creates a new value column. 
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The attribute can be assigned dynamic properties by means of the name ValueColumnAdd. 
The data type is STRING. 


ValueColumnAlign property 
Alignment - ValueColumnAlign 


Defines the mode of alignment of a selected value column. 


The following settings are available: 


Value Description Explanation 

0 left The selected value column is displayed on the left. 
1 Centered The selected value column is aligned to center. 

2 right The selected value column is displayed on the right. 


The attribute can be assigned dynamic properties by means of the name ValueColumnAlign. 
The data type is LONG. 


ValueColumnAlignment Property 


Description 
The "Index" property references a pair of columns. "ValueColumnAlignment" defines the 
alignment of the tag value for this column pair. 
e 0: Tag values are entered aligned left. 
e 1: Tag values are entered centered. 
e 2: Tag values are entered aligned right. 
See also 


WinCC Online Table Control (before WinCC V7) (Page 292) 
Screenltem Object (Page 125) 


ValueColumnAutoPrecisions property 


Automatic - ValueColumnAutoPrecisions 


Enables automatic setting of the decimal precision. 


Value Explanation 


TRUE The decimal precision is defined automatically. The value in the "Decimal places" or "ValueColumnPre- 
cisions" field is disabled. 


FALSE The value in the "Decimal places" or "ValueColumnPrecisions" field is active. 
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The attribute can be assigned dynamic properties by means of the name 
ValueColumnAutoPrecisions. The data type is BOOLEAN. 


ValueColumnBackColor property 


Background color - ValueColumnBackColor 


Specifies the background color of the value column selected. Use the button to open the "Color 
selection" dialog. 


The setting is only active if the "Background color" option is set or "UseColumnBackColor" is 
"TRUE" in the "Use column color" field of the "General" tab. 


The attribute can be assigned dynamic properties by means of the name 
ValueColumnBackColor. The data type is LONG. 


ValueColumnCaption property 


Description - ValueColumnCaption 
Defines the label of the value column selected. 


The attribute can be assigned dynamic properties by means of the name 
ValueColumnCaption. The data type is STRING. 


ValueColumnCount property 


ValueColumnCount 
Defines the number of value columns configured. 


The attribute can be assigned dynamic properties by means of the name ValueColumnCount. 
The data type is LONG. 


ValueColumnExponentialFormat property 


Exponential notation - ValueColumnExponentialFormat 


Sets exponential notation for the display of values of a value column selected. 


Value Explanation 
TRUE Display with exponential notation. 
FALSE Display with decimal notation. 


The attribute can be assigned dynamic properties by means of the name 
ValueColumnExponentialFormat. The data type is BOOLEAN. 
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ValueColumnForeColor property 


Font color - ValueColumnForeColor 


Specifies the font color of the value column selected. Use the button to open the "Color 
selection" dialog. 

The setting is only active if the "Font color" option is set or "UseColumnForeColor" is "TRUE" 
in the "Use column color" field of the "General" tab. 


The attribute can be assigned dynamic properties by means of the name 
ValueColumnForeColor. The data type is LONG. 


ValueColumnHideText property 


ValueColumnHideText 
Sets text format for displaying the content of a value column. 
Value Explanation 
TRUE The content is not displayed in text format. 
FALSE The content is displayed in text format. 


The attribute can be assigned dynamic properties by means of the name 
ValueColumnHideText. The data type is BOOLEAN. 


ValueColumnHideTitleText property 


ValueColumnHideTitle Text 
Sets text format for displaying the value column header. 
Value Explanation 
TRUE The header is not displayed in text format. 
FALSE The header is displayed in text format. 


The attribute can be assigned dynamic properties by means of the name 
ValueColumnHideTitleText. The data type is BOOLEAN. 


ValueColumnindex property 


ValueColumnIindex 
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References a configured value column. Using this attribute you can assign the values of other 
attributes to a specific value column. 


Values between 0 and "ValueColumnCount" minus 1 are valid for "ValueColumnIndex". 
Attribute "ValueColumnCount" defines the number of value columns configured. 
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The "ValueColumnIndex" attribute can be assigned dynamic properties by means of attribute 
ValueColumnRepos. The data type is LONG. 


ValueColumnLength property 


Length in characters - ValueColumnLength 
Specifies the width of a selected value column. 


The attribute can be assigned dynamic properties by means of the name 
ValueColumnLength. The data type is LONG. 


ValueColumnName property 


Object name - ValueColumnName 
Specifies the name of a selected value column. 


The "ValueColumnName" attribute can be assigned dynamic properties by means of attribute 
ValueColumnRename. The data type is STRING. 


ValueColumnPrecisions property 


Decimal places - ValueColumnPrecisions 


Specifies the decimal precision for displaying the data of a value column selected. The value 
can be entered if the "Automatic" option is disabled or "ValueColumnAutoPrecisions" is 
"FALSE". 


The attribute can be assigned dynamic properties by means of the name 
ValueColumnPrecisions. The data type is SHORT. 


ValueColumnProvider property 


Data source - ValueColumnProvider 


Specifies the data source for a selected value column. 


The following settings are available: 


Description Explanation 
1 Archive tags Data source with archive tags of a process value archive. 
2 Online tags Data source with online tags derived from tag management. 


The attribute can be assigned dynamic properties by means of the name 
ValueColumnProvider. The data type is LONG. 
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ValueColumnProviderCLSID property 


ValueColumnProviderCLSID 
Indicates the data source of the value column selected. 


Explanation 
{416A09D2-8B5A-1 1D2- Data source with archive tags of a process value archive. 
8B81-006097A45D48} 
{A3F69593-8AB0-1 1D2- Data source with online tags derived from tag management. 


A440-00A0C9DBB64E} 


The attribute can be assigned dynamic properties by means of the name 
ValueColumnProviderCLSID. The data type is STRING. 


ValueColumnRemove property 


Remove - ValueColumnRemove 
Removes the selected value column from the list. 


The attribute can be assigned dynamic properties by means of the name 
ValueColumnRemove. The data type is STRING. 


ValueColumnRename property 


ValueColumnRename 
Renames a value column which is referenced by means of "ValueColumnIndex" attribute. 


The attribute can be assigned dynamic properties by means of the name 
ValueColumnRename. "ValueColumnRename" also sets a dynamic attribute 
"ValueColumnName". The data type is STRING. 


ValueColumnRepos property 


Up/Down - ValueColumnRepos 
Changes the sorting order of the value columns. "Up" and "Down" move the value column 
selected up or down in the list. 


The sorting order in the list determines the order of value columns after the time column if 
several value columns are assigned to the same time column. Higher positions of the value 
column in the list moves it to closer proximity towards the time column. 


You change the order of time columns and their assigned value columns in the "Time columns" 
tab. 


The attribute can be assigned dynamic properties by means of the name 
ValueColumnRepos. The data type is LONG. 
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ValueColumnSelectTagName property 


ValueColumnSelectTagName 


Opens a dialog for selecting the tag name for the data source of the value column in WinCC 
OnlineTableControl. Programmers can set this attribute to allow users to select a tag name by 
means of a button, for example. 


The attribute can be assigned dynamic properties by means of the name 
ValueColumnSelectTagName. The data type is BOOLEAN. 


ValueColumnShowlcon property 


ValueColumnShowlcon 
Enables the display of value column contents as icon. 


Value Explanation 
TRUE The content is visualized as icon. 
FALSE The content is not visualized as icon. 


The attribute can be assigned dynamic properties by means of the name 
ValueColumnShowlcon. The data type is BOOLEAN. 


ValueColumnShowTitlelcon property 


ValueColumnShowTitlelcon 
Enables display of the value column header as icon. 


Value Explanation 
TRUE The header is displayed as icon. 
FALSE The header is not displayed as icon. 


The attribute can be assigned dynamic properties by means of the name 
ValueColumnShowTitlelcon. The data type is BOOLEAN. 


ValueColumnSort property 


ValueColumnSort 
Defines the sorting order of the value column referenced in "ValueColumnIndex" . 
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The following settings are available: 


Value Description Explanation 

0 No No sorting 

1 Ascending Ascending order, starting at the lowest value. 

2 Descending Descending order, starting at the highest value. 


The attribute can be assigned dynamic properties by means of the name ValueColumnSort . 
The data type is LONG. 


ValueColumnSortindex property 


ValueColumnSortIndex 


Defines the sorting order of the value column referenced in "ValueColumnIndex". The sorting 
criterion is removed from "ValueColumnSort" if you set a "0" value.. 


The attribute can be assigned dynamic properties by means of the name 
ValueColumnSortindex. The data type is LONG. 


ValueColumnState property 


ValueColumnState 
Displays the data connection status of a selected value column in Runtime. 


The attribute can be assigned dynamic properties by means of the name ValueColumnState. 
The data type is LONG. 


ValueColumnTagName property 


Tag name - ValueColumnTagName 


Displays the name of connected tags. You can change the tag connection using the selection 
button. 


The attribute can be assigned dynamic properties by means of the name 
ValueColumnTagName. The data type is STRING. 


ValueColumnTimeColumn property 


Time column - ValueColumnTimeColumn 


Specifies the time column for displaying the value column selected. Define the available time 
columns in the "Time columns" tab. 


The attribute can be assigned dynamic properties by means of the name 
ValueColumnTimeColumn. The data type is STRING. 
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ValueColumnVisible property 


Value columns - ValueColumnVisible 


The list shows all value columns you created. Click a value column entry in the list to adapt 
the properties, to assign the value column, and to define the data connection. 


Select the value columns to be displayed in the table from the list. Value columns are displayed 
if interconnected with a time column. 


The attribute can be assigned dynamic properties by means of the name 
ValueColumnVisible . The data type is BOOLEAN. 


ValueMax Property 


Description 


Defines the value at the end of the scale. Write/Read access. 
See also 
WinCC Gauge Control (Page 254) 


Screenltem Object (Page 125) 


ValueMin Property 


Description 
Defines the value at the start of the scale. Write/Read access. 
See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 
Variable Property 
Description 


The "Index" property references a pair of columns. "Tag" defines the name of the tag which 
should be connected to this column pair. 
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See also 
WinCC Online Table Control (before WinCC V7) (Page 292) 
Screenltem Object (Page 125) 

VerticalGridLines property 


Vertical - VerticalGridLines 


Enables the display of vertical dividers. 


Value Explanation 
TRUE Enables the displays of vertical dividers. 
FALSE Disables the display of vertical dividers. 


The attribute can be assigned dynamic properties by means of the name VerticalGridLines. 
The data type is BOOLEAN. 


Visible Property 


Description 
witches an object visible or invisible or issues a corresponding value: 
e TRUE : Object is visible 
e FALSE : Object is invisible 
VARIANT_BOOL (write-read access) 


Example: 
The following example sets all the objects in the picture "NewPDL1" to invisible: 


"VBS95 

Dim objScreen 

Dim objScriItem 

Dim lIngIndex 

Dim strName 

IngIndex = 1 

Set objScreen = HMITRuntime.Screens ("NewPDL1") 
For lIngIndex = 1 To objScreen.ScreenItems.Count 
strName = objScreen.ScreenItems (IngIndex) .ObjectNam 
Set objScriItem = objScreen.ScreenItems (strName) 
objScriItem.Visible = False 

Next 
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See also 
Screenltem Object (Page 125) 
Layer Object (Page 120) 
HM IRuntime Object (Page 118) 
1.14.4.22 Ww 
Warning Property 
Description 
Defines the start of the "Warning zone" as a scale value. Write/Read access. 
See also 
WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 
WarningColor Property 
Description 
Defines the color of the "Warning zone" o the scale. LONG write-read access. 
See also 


WinCC Gauge Control (Page 254) 
Screenltem Object (Page 125) 


WarningHigh Property 


Description 


Defines or returns the upper limit value for "Warning High". 

In order that the limit value is monitored, the "CheckWarningHigh" property must be set to 
TRUE. 

The display on reaching the limit value and the type of evaluation are defined by means of the 
"ColorWarningHigh" and "TypeWarningHigh" properties. 
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See also 
Bar (Page 174) 
Screenltem Object (Page 125) 
WarningLow Property 
Description 
Defines or returns the lower limit value for "Warning Low". 
In order that the limit value is monitored, the "CheckWarningLow" property must be set to 
TRUE. 
The display on reaching the limit value and the type of evaluation are defined by means of the 
"ColorWarningLow" and "TypeWarningLow" properties. 
See also 


Bar (Page 174) 
Screenltem Object (Page 125) 


Width Property 
Description 


Sets or outputs the width of an object in pixels. 
LONG 
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"VBS 96 

Dim objScreen 
Dim cmdButton 
Dim lngIndex 
Dim strName 
IngIndex = 1 
Set objScreen 
For lIngIndex 
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The following example doubles the width of all objects in the pictures "NewPDL1" whose name 
begins with "Button": 


HMTRuntime.Screens ("NewPDL1") 
1 To objScreen.ScreenItems.Count 


"Get all "Buttons" 
strName = objScreen.ScreenItems (lngIndex) .ObjectNam 


If "Button" = 
Set cmdButton 
cmdButton.Width 


Left (strName, 6) Then 


objScreen.ScreenItems (strName) 
= cmdButton.Width * 2 


End If 
ext 

See also 
Height Property (Page 443) 
Screenltem Object (Page 125) 

WinCCStyle property 

Description 
Defines the style in which the object is displayed. 
User Defined Shows the object according to the respective settings. 
Global Shows the object in a globally defined design. 
Windows Style Shows the object in Windows style. 

WindowBorder Property 

Description 


TRUE, when the window is displayed with borders in Runtime. Read only access. 
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See also 
Picture Window (Page 179) 
Application Window (Page 173) 
Screenltem Object (Page 125) 


WindowPositionMode property 


Description 
Defines the position and scaling of the picture window on the screen. It is only effective if the 
"Independent window" attribute is set to TRUE. 
Standard The picture window is positioned in its original size in the configured position on 
the screen. 
Center The picture window is positioned in its original size, centered on the screen. 
Maximize The picture window is scaled to the size of the screen. 
WindowsStyle property 
Description 
Defines whether the object is displayed in the Windows style of WinCC version 6.2. It can only 
be selected if "WinCC Classic" is chosen as the current design. 
TRUE if the object is displayed in the Windows style of WinCC version 6.2. 
FALSE if the object is not displayed in the Windows style of WinCC version 6.2. 
WindowsStyle Property 
Description 


TRUE, when the object complies with the general Windows style (e.g. gray buttons without 
borders). BOOLEAN write-read access. Note: 


e When this property is set to "True", the properties which do not comply with the Windows 
style are ignored (e.g. "BorderWidth"). 


@ On the other hand, the definition of a "BorderWidth" or a background color other than gray 
causes "WindowsStyle" to receive the value"False". 


e Exceptions here are the flash attributes: The definition of flash attributes does not 
automatically lead to the deactivation of the "WindowsStyle" attribute. 
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See also 
Slider (Page 212) 
Button (Page 201) 
Screenltem Object (Page 125) 
WindowType Property 
Description 
Defines the use of the message window. 
@ 0 - Message list: shows the currently pending messages. 
e 1 - Short-term archive list: shows the archived messages. 
e 2-Long-term archive list: shows the archived messages. 
e 3- Lock list: shows the currently locked messages. 
e 4-Hit list: To display the statistical information of messages. 
See also 
WinCC Alarm Control (before WinCC V7) (Page 286) 
Screenltem Object (Page 125) 
WithAxes Property 
Description 
TRUE, when the scale should be displayed. BOOLEAN write-read access. 
See also 
WinCC Slider Control (Page 277) 
Screenltem Object (Page 125) 
WithLabels Property 
Description 


TRUE, when the scale labels should be displayed. BOOLEAN write-read access. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 701 


VBS for Creating Procedures and Actions 


7.14 VBS Reference 


See also 


1.14.4.23 


WinCC Slider Control (Page 277) 
Screenltem Object (Page 125) 


X-Z 


XAxisColor property (before WinCC V7) 


Description 
Use this attribute to define the color for the common X-axis. The color is defined as an RGB 
value. LONG write-read access. 

X/YAxisAdd property 


New - X/YAxisAdd 


Creates a new X or Y axis. 

The X axis attribute can be assigned dynamic properties by means of the name XAxisAdd . 
The Y axis attribute can be assigned dynamic properties by means of the name YAxisAdd . 
The data type is STRING. 


X/YAxisAlign property 


Alignment - X/YAxisAlign 


702 


Defines the alignment mode for a selected axis. 


The following settings are available for the X axis: 


Description Explanation 


The X axis selected is displayed below the trend. 
1 Top The X axis selected is displayed above the trend. 


The X axis attribute can be assigned dynamic properties by means of the name XAxisAlign. 
The data type is LONG. 


The following settings are available for the Y axis: 


Value | Description Explanation 
0 left The X axis selected is displayed on left side of the trend. 
1 right The X axis selected is displayed on right side of the trend. 


The Y axis attribute can be assigned dynamic properties by means of the name YAxisAlign. 
The data type is LONG. 
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X/YAxisAutoPrecisions property 


Decimal places automatic - X/YAxisAutoPrecisions 


Value 
TRUE 


Enables automatic setting of the decimal precision. 


Explanation 
The number of decimal places is set automatically. The value in the "Decimal places" or "X/YAxisPreci- 
sions" field is disabled. 


FALSE 


The value in the "Decimal places" or "X/YAxisPrecisions" field is active. 


The X axis attribute can be assigned dynamic properties by means of the name 
XAxisAutoPrecisions. 


The Y axis attribute can be assigned dynamic properties by means of the name 
YAxisAutoPrecisions. 


The data type is BOOLEAN. 


X/YAxisAutoRange property 


Value range automatic - X/YAxisAutoRange 


Enables automatic calculation of the value range of the axis selected. 


Value 
TRUE 


Explanation 
The range of values is calculated automatically. 


FALSE 


The range of values is calculated based on the values configured in the "from" and "to" or "X/YAxisBeginValue" 
and "X/YAxisEndValue" fields. 


The X axis attribute can be assigned dynamic properties by means of the name 
XAxisAutoRange. 


The Y axis attribute can be assigned dynamic properties by means of the name 
YAxisAutoRange. 


The data type is BOOLEAN. 


X/YAxisBeginValue property 


Value range from - X/YAxisBeginValue 


Specifies the lower range of values of the axis selected. You can configure the value if the 
"Automatic" option is disabled or "X/YAxisAutoRange" is "FALSE". 


The X axis attribute can be assigned dynamic properties by means of the name 
XAxisBeginValue. 


The Y axis attribute can be assigned dynamic properties by means of the name 
YAxisBeginValue. 


The data type is DOUBLE. 
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X/YAxisColor property 


Color XY axis - X/YAxisColor 


Specifies the color of the axis selected. The button opens the "Color selection" dialog to select 
the color. 


The setting is only active if the "Use trend color" field is disabled or "X/YAxisInTrendColor" is 
"FALSE". 


The X axis attribute can be assigned dynamic properties by means of the name XAxisColor. 
The Y axis attribute can be assigned dynamic properties by means of the name YAxisColor. 
The data type is LONG. 


X/YAxisEndValue property 


Value range to - X/YAxisEndValue 


Specifies the upper range of values of the axis selected. You can configure the value if the 
"Automatic" option is disabled or "X/YAxisAutoRange" is "FALSE". 


The X axis attribute can be assigned dynamic properties by means of the name 
XAxisEndValue. 


The Y axis attribute can be assigned dynamic properties by means of the name 
YAxisEndValue. 


The data type is DOUBLE. 


X/YAxisExponentialFormat property 


Exponential notation - X/YAxisExponentialFormat 


Enables the exponential notation for visualization of a selected axis. 


Value Explanation 
TRUE The values are displayed with exponential notation. 
FALSE The values are displayed with decimal notation. 
The X axis attribute can be assigned dynamic properties by means of the name 
XAxisExponentialFormat. 
The Y axis attribute can be assigned dynamic properties by means of the name 
YAxisExponentialFormat. 
The data type is BOOLEAN. 
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X/YAxisInTrendColor property 


Use trend color - X/YAxisInTrendColor 


Enables the display of an axis selected in the trend color. The color of the first trend is activated 
if several trends are displayed in the trend window. Define the order of trends on the "Trends" 


tab. 
Value Explanation 
TRUE The axis selected is displayed in the trend color. The setting in the "Color" or "X/YAxisColor" 


field is disabled. 
FALSE The axis selected is displayed in the color set in the "Color" or "X/YAxisColor" field. 


The X axis attribute can be assigned dynamic properties by means of the name 
XAxisInTrendColor. 


The Y axis attribute can be assigned dynamic properties by means of the name 
YAxisInTrendColor. 


The data type is BOOLEAN. 


X/YAxisLabel property 


Label - X/YAxisLabel 
Defines the label text for a selected axis. 
The X axis attribute can be assigned dynamic properties by means of the name XAxisLabel. 
The Y axis attribute can be assigned dynamic properties by means of the name YAxisLabel. 


The data type is STRING. 


X/YAxisName property 


Object name - X/YAxisName 
Specifies the name of a selected axis. 


Attribute "XAxisName" can be assigned dynamic properties for the X axis by means of 
XAxisRename attribute. 


Attribute "YAxisName" can be assigned dynamic properties for the Y axis by means of 
YAxisRename attribute. 


The data type is STRING. 
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X/YAxisPrecisions property 


Decimal places - X/YAxisPrecisions 


Specifies the decimal precision for displaying the axis selected. The value can be configured 
and is active in Runtime, if the "Automatic" option is disabled or "X/YAxisAutoPrecisions" is 
"FALSE". 


The X axis attribute can be assigned dynamic properties by means of the name 
XAxisPrecisions. 


The Y axis attribute can be assigned dynamic properties by means of the name 
YAxisPrecisions. 


The data type is SHORT. 


X/YAxisRemove property 


Remove - X/YAxisRemove 
Removes the selected axis from the list. 


The X axis attribute can be assigned dynamic properties by means of the name 
XAxisRemove . 


The Y axis attribute can be assigned dynamic properties by means of the name 
YAxisRemove . 


The data type is STRING. 


X/YAxisRepos property 


Up/Down - X/YAxisRepos 


Changes the sorting order of the axes. "Up" and "Down" move the axis selected up or down 
in the list. 


The list order determines the axis position in the trend window. The axis output position is 
moved away from the trend if the axis is moved further up in the list and the orientation is the 
same. 


The X axis attribute can be assigned dynamic properties by means of the name XAxisRepos . 
The Y axis attribute can be assigned dynamic properties by means of the name YAxisRepos . 


The data type is LONG. 


X/YAxisScalingType property 


Scaling - X/YAxisScalingType 
Defines the scaling mode for a selected axis. 
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The following settings are available: 


Description 
Linear 


Logarithmic 


Logarithmically negated 


The X axis attribute can be assigned dynamic properties by means of the name 
XAxisScalingType. 


The Y axis attribute can be assigned dynamic properties by means of the name 
YAxisScalingType. 


The data type is LONG. 


X/Y Axis TrendWindow property 


Trend window - X/YAxisTrendWindow 


Specifies the trend window for a selected axis. Define the available trend windows in the "Trend 
window" tab. 


The X axis attribute can be assigned dynamic properties by means of the name 
XAxisTrendWindow. 


The Y axis attribute can be assigned dynamic properties by means of the name 
YAxisTrendWindow. 


The data type is STRING. 


X/YAxisVisible property 


XIY axes - X/YAxisVisible 


The list shows all axes you created. Click an axis entry in the list to adapt the properties and 
to assign the axis to a trend window. 


Activate the axes to be displayed in the trend windows in the list. 


The X axis attribute can be assigned dynamic properties by means of the name 
XAxisVisible . 


The Y axis attribute can be assigned dynamic properties by means of the name 
YAxisVisible . 


The data type is BOOLEAN. 


XAxisCount property 


XAxisCount 


Defines the number of X axes configured. 
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The attribute can be assigned dynamic properties by means of the name XAxisCount. The 
data type is LONG. 


XAxisIndex property 


XAxisIndex 


References a configured X axis. Using this attribute you can assign the values of other 
attributes to a specific X axis. 


Values between 0 and "XAxisCount" minus 1 are valid for "Index"; the attribute "XAxisCount" 
defines the number of configured X axes. 


The "XAxisIndex" attribute can be assigned dynamic properties by means of attribute 
XAxisRepos. The data type is LONG. 


XAxisRename property 


XAxisRename 
Renames the X axis which is referenced by means of "XAxisIndex" attribute. 
The attribute can be assigned dynamic properties by means of the name XAxisRename. 
"XAxisRename" also sets a dynamic attribute "XAxisName". The data type is STRING. 
YAxisCount property 
YAxisCount 
Defines the number of Y axes configured. 
The attribute can be assigned dynamic properties by means of the name YAxisCount. The 
data type is LONG. 
YAxisIndex property 
YAxisIndex 


References a configured Y axis. Using this attribute you can assign the values of other 
attributes to a specific Y axis. 


Values between 0 and "YAxisCount" minus 1 are valid for "Index". Attribute "YAxisCount" 
defines the number of configured Y axes. 


The "YAxisIndex" attribute can be assigned dynamic properties by means of attribute 
YAxisRepos. The data type is LONG. 
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YAxisRename property 


YAxisRename 
Renames the Y axis which is referenced by means of "YAxisIndex" attribute. 


The attribute can be assigned dynamic properties by means of the name YAxisRename. 
"YAxisRename" also sets a dynamic attribute "YAxisName". The data type is STRING. 


ZeroPoint Property 


Description 


Defines or returns the position of the zero point of the bar graph. 

Specify the value as a %age of the total bar height. The zero point can also be outside of the 
range represented. 

The "ScalingType" property must be set to "2" and "Scaling" to TRUE. 


See also 
Screenltem Object (Page 125) 
Bar (Page 174) 
ZeroPointValue Property 
Description 
Defines the value of the zero point of the scale indicator. 
Defines or returns the absolute value for the zero point. 
See also 


Bar (Page 174) 
3D Bar (Page 169) 
Screenltem Object (Page 125) 


Zoom Property 


Description 
Sets the zoom factor within a picture or picture window or reads it out. 


If the indicated zoom factor is smaller than the minimum value, the zoom factor is automatically 
set to the minimum value. If the indicated zoom factor is larger than the minimum value, the 
zoom factor is automatically set to the maximum value. 
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The minimum value of the zoom factor is at 2%, the maximum value at 800%. 


With the Screen Object the zoom factor is indicated as a numeric value and with a picture 
window object, it is indicated in percent. 


Example: 


The following example doubles the zoom factor of the current picture: 


"VBS97 
HMTRuntime.ActiveScreen.Zoom = HMIRuntime.ActiveScreen.Zoom * 2 


See also 
Picture Window (Page 179) 
Screen Object (Page 131) 
1.14.5 Methods 
1.14.5.1 Methods 
Overview 


Methods, which are applied to individual objects, can be used to read out tag values for further 
processing or displaying diagnostics messages in Runtime. 


Available Methods in VBS 


Activate GetStatusbarElement MoveToNext ShowlnfoText 
ActivateDynam- GetStatusbarElementCollection MoveToNextLine ShowLockDialog 

ic 

Add GetTimeAxis MoveToNextPage ShowLockList 
AttachDB GetTimeAxisCollection MoveToPrevious ShowLongTermArchiveList 
CalculateStatis- GetTimeColumn MoveToPreviousLine ShowMessageList 

tic 

CopyRows GetTimeColumnCollection MoveToPreviousPage ShowPercentageAxis 
CreateTagSet GetToolbarButton NextColumn ShowPropertyDialog 
CutRows GetToolbarButtonCollection NextTrend ShowSelectArchive 
DeactivateDy- GetTrend OneToOneView ShowSelection 

namic 

DeleteRows GetTrendCollection PasteRows ShowSelectionDialog 
DetachDB GetTrendWindow PreviousColumn ShowSelectTimeBase 
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Edit 

Export 
GetColumn 
GetColumnCol- 
lection 
GethHitlistCol- 
umn 
GethitlistCo- 
lumnCollection 
GetMessage- 
Block 
GetMessage- 
BlockCollection 


GetMessage- 
Column 
GetMessage- 
ColumnCollec- 
tion 
GetOperator- 
Message 


GetOperator- 


MessageCollec- 


tion 
GetRulerBlock 
GetRulerBlock- 
Collection 
GetRulerCol- 
umn 
GetRulerCo- 
lumnCollection 
GetRulerData 
GetStatisticAr- 
eaColumn 


GetStatisticAr- 
eaColumnCol- 
lection 
GetStatisticRe- 
sultColumn 
GetStatisticRe- 
sultColumnCol- 
lection 


GetTrendWindowCollection 
GetValueAxis 
GetValueAxisCollection 
GetValueColumn 


GetValueColumnCollection 


GetXAxis 


GetXAxisCollection 


GetYAxis 


GetYAxisCollection 


HideAlarm 


Item Method 


LockAlarm 


LoopInAlarm 


MoveAxis 


MoveRuler (Page 772) 


MoveToFirst 


MoveToFirstLine 
MoveToFirstPage 


MoveToLast 


MoveToLastLine 


MoveToLastPage 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 


PreviousTrend 
Print 

QuitHorn 
QuitSelected 


QuitVisible 


Read 


ReadTags 


Refresh 


Remove 


RemoveAll 


Restore 


SelectedStatisticArea 


ServerExport 


Serverlmport 


ShowColumnSelection 


ShowComment 


ShowDisplayOptionsDialog 
ShowEmergencyQuitDialog 


ShowHelp 


ShowHideList 


ShowHitList 
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ShowShortTermArchiveList 
ShowSort 

ShowSortDialog 
ShowTagSelection 


ShowTimebaseDialog 


ShowTimeSelection 


ShowTrendSelection 


StartStopUpdate 


Stop 


Trace 


UnhideAlarm 


UnlockAlarm 


Write 


WriteTags 


ZoomArea 


ZoomInOut 


Zoom|nOutTime 


ZoomI|nOutValues 


Zoom|InOutX 


Zoom|InOutY 


ZoomMove 
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1.14.5.2 Methods A to E 


Activate Method 


Function 
Activates the specified picture and picture element, respectively. 


Note 


Focus assignments should not be configured during a ButtonDown event. Since the focus is 
specifically requested during the ButtonDown event, invalid states may occur. 


Syntax 


Expression.Activate 


Expression 
Necessary. An expression which returns an object of type "Screen" or "Screenltem". 


Parameters 


Examples 
The following example shows the use for type "Screen": 


"VBS 98 

Dim objScreen 

MsgBox HMIRuntime.ActiveScreen.ObjectNam "Output of active screen 

Set objScreen = HMTRuntime.Screens ("ScreenWindowl1") 

objScreen.Activate ‘Activate "ScreenWindowl" 

MsgBox HMIRuntime.ActiveScreen.ObjectNam "New output of active screen 


The following example shows the use for type "Screenltem": 


"VBS158 

MsgBox HMIRuntime.ActiveScreen.ActiveScreenItem. ObjectNam "Output of active screen item 
HMIRuntime.ActiveScreen.ScreenItems ("IOField1") .Activate 

MsgBox HMIRuntime.ActiveScreen.ActiveScreenItem. ObjectNam 'New output of active screen 
item 
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See also 
Screenltem Object (Page 125) 
Screen Object (Page 131) 


ActivateDynamic method 


Function 
Dynamically activates a trigger for the defined property and with the defined cycle during 
runtime. Every time the trigger is activated a different activation cycle can be used. 
Examples of this method are available in chapter "VBS for creating procedures and action > 
Creating and editing actions > Trigger > Animation trigger’. 
Syntax 
Expression.ActivateDynamic (ByVA1l bstrPropertyName As String, ByVal 
bstrCycleName As String) 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
Parameters Description 
bstrPropertyName Name of property to which trigger relates. 
bstrCycleName Name of activation cycle, e.g. "CycleTime1s". 
See also 
Animation trigger (Page 68) 
Add Method 


Description of TagSet Object 


Adds a tag to the list. A tag may be added to the tag object by using name or reference. 


syntax 


Expression.Add [Tag] 
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Expression 
Necessary. An expression which returns an object of type "TagSet". 


Parameters 
VARIANT 
Parameters Description 
Tag Name of a WinCC tag or reference to a tag object 
to be added to the list. 
Example: 
In the following example, a TagSet object is generated and a tag is added. 
'VBS170 


Dim group 
Set group = HMIRuntime.Tags.CreateTagSet 
group.Add "Motor1" 


Tag objects may also be added as follows. 


"VBS171 

Dim Tag 

Set Tag = HMIRuntime.Tags ("Motor2") 

Dim group2 

Set group2 = HMIRuntime.Tags.CreateTagSet 
group2.Add Tag 


Description of DataSet Object 
Adds a value or object reference to the list. 


Note 


The Data Set Object does not support classes. 

Objects of type Screen, Screens, Screenltem, Screenltems, Tag and TagSet cannot be 
included in the DataSet list. 

For object references it must be ascertained that objects are multiread-enabled. 


syntax 


Expression.Add [vtName], [vtUserData] 
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Necessary. An expression which returns an object of type "DataSet". 


Description 
Name by which value or tag are to be added to list. 


Value to be added to list. 


In this example, a value is included in the DataSet list. 


Parameters 
VARIANT 
Parameters 
vtName 
vtUserData 
Example: 
"VBS172 


HMTRuntime.DataSet.Add "Motor1", 23 


See also 


TagSet Object (List) (Page 141) 
DataSet Object (List) (Page 116) 


AttachDB method 


Function 


Executes the "Connect backup" key function of the control. 


Syntax 


Ausdruck.AttachDB () 


Expression 


Necessary. An expression that returns an object of the "Screenltem" type. 


Parameters 
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CalculateStatistic method 


Function 


Syntax 


Parameters 


Executes the "Calculate statistics" key function of the OnlineTrendControl and 
OnlineTableControl. 


Ausdruck.CalculateStatistic () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


CopyRows method 


Function 


Syntax 


Parameters 


Create method 


Function 


Syntax 
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Executes the "Copy lines" key function of the control. 


Ausdruck.CopyRows () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


Creates a new Alarm object. 


Expression.Create (VARIANT vtApplication) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


VBS for Creating Procedures and Actions 


Expression 
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Necessary. An expression which returns an object of type "Alarm". 


Parameters 

VARIANT 

Parameters Description 

vtApplication Name of alarm object (optional) 
See also 

Alarms object (list) (Page 110) 
CreateTagSet Method 
Function 

Creates a new TagSet object. This object may be used for optimized multi-tag access. 
syntax 

Expression. CreateTagSet () 

Expression 

Necessary. An expression which returns an object of type "TagSet". 
Parameters 

VARIANT 
Example: 

The following example shows how to create a TagSet object. 

'VBS168 


"Build a Reference to the TagSet Object 
Dim group 
Set group = HMIRuntime.Tags.CreateTagSet 
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See also 
TagSet Object (List) (Page 141) 
Tags Object (List) (Page 140) 


CutRows method 


Function 

Executes the "Cut lines" key function of the UserArchiveControl. 
Syntax 

Ausdruck.CutRows () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


DeactivateDynamic method 


Function 
Deactivates the trigger used with the "ActivateDynamic" method for the defined property during 
runtime. 
Syntax 
Ausdruck.DeactivateDynamic (ByVal bstrPropertyName As String) 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
String 
Parameters Description 


bstrPropertyName Name of property to which trigger relates. 
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DeleteRows method 


Function 


Syntax 


Parameters 


Executes the "Delete Rows" key function of the UserArchiveControl. 


Ausdruck.DeleteRows () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


DetachDB method 


Function 


Syntax 


Parameters 


Edit method 


Function 


Syntax 


Executes the "Disconnect backup" key function of the control. 


Ausdruck.DetachDB () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


Executes the "Edit" key function of the OnlineTableControl. 


Ausdruck.Edit () 
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Parameters 


Export Method 


Function 


Syntax 


Parameters 


1.14.5.3 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


Executes the "Export archive" or "Export data" key function of the control. 


Ausdruck.Export () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


VARIANT 


Get methods 


GetColumn method 


Function 


Syntax 
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Returns the name or index designated column object of the WinCC UserArchiveControl as 
type "ICCAxUAColumn". 


Ausdruck.GetColumn (ByVal viIndex As Variant) 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
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Parameters 
VARIANT 
vindex Index or name of column of UserArchiveControl. 
Example 
"VBS312 
Dim ctrl 


Dim objColumn 

Set ctrl = ScreenItems ("UAControl") 

Set objColumn = ctrl.GetColumn ("Fieldl1") 
objColumn.Length = 30 

Set objColumn = ctrl.GetColumn (3) 
objColumn.Align = 2 


Note 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. 


For the "Column" listing, for example, you write "objColumn.Align" instead of 
"“objColumn.ColumnAlign”. 


See also 
Column object (list) (Page 221) 


GetColumnCollection method 


Function 


Returns the list of all column objects of the WinCC UserArchiveControl as type 
"ICCAxCollection". 


Syntax 


Ausdruck.GetColumnCollection() 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
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Parameters 


Features and functions of the ICCAxCollection 
The following properties are available for the |CCAxCollection: 
e Count 
e Item 
The following functions are available for the ICCAxCollection: 
@ Addlitem(vName) As Object 


e Removeltem(vindex) 


Example 


'VBS313 

Dim ctrl 

Dim coll 

Dim field 

Set ctrl = ScreenItems ("UAControl") 

Set coll ctrl.GetColumnCollection 
HMIRuntime.Trace "Number of fields:" & coll.Count & vbCrLf 
For Each field In coll 

HMITRuntime.Trace field.Name & vbCrLf 
HMIRuntime.Trace field.Type & vbCrLf 
HMIRuntime.Trace field.Length & vbCrLf 
HMTRuntime.Trace field.Caption & vbCrLf 

Next 


See also 
Column object (list) (Page 221) 


GetHitlistColumn method 


Function 


Returns the name or index designated column object of the hitlist of the WinCC AlarmControl 
as type "ICCAxMessageColumn". 


Syntax 


Expression.GetHitlistColumn (ByVal viIndex As Variant) 
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Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


Parameters 
VARIANT 
Parameters Description 
vindex Index or name of hitlist column 
Example 
'VBS314 
Dim ctrl 
Dim objHitlistColumn 
Set ctrl = ScreenItems ("AlarmControl") 


Set objHitlistColumn = ctrl.GetHitlistColumn ("Date") 
objHitlistColumn.Sort = 2 
Set objHitlistColumn = ctrl.GetHitlistColumn ("AverageComeGo") 
objHitlistColumn.Visible = FALSE 


Note 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. 


For the "HitlistColumn" listing, for example, you write "objHitlistColumn.Visible" instead of 
“objHitlistColumn.HitlistColumnvVisible". 


See also 
HitlistColumn object (list) (Page 222) 


GetHistlistColumnCollection method 


Function 


Returns the list of all column objects of the WinCC AlarmControl hitlist as type 
"ICCAxCollection”. 


Syntax 


Expression.GetHitlisteColumnCollection () 
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Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


Parameters 


Features and functions of the ICCAxCollection 
The following properties are available for the ICCAxCollection: 
e Count 
e Item 
The following functions are available for the ICCAxCollection: 
@ Addlitem(vName) As Object 


e Removeltem(vindex) 


Example 


"VBS315 

Dim ctrl 

Dim coll 

Dim hitlistcol 

Set ctrl = ScreenItems ("AlarmControl") 

Set coll = ctrl.GetHitlistColumnCollection 
HMTRuntime.Trace "Number of hitlist columns:" & coll.Count & vbCrLf 
For Each hitlistcol In coll 

HMITRuntime.Trace hitlistcol.Index & vbCrLf 
HMITRuntime.Trace hitlistcol.Name & vbCrLf 
HMITRuntime.Trace hitlistcol.Sort & vbCrLf 
HMITRuntime.Trace hitlistcol.SortIndex & vbCrLf 


Next 
See also 
HitlistColumn object (list) (Page 222) 
GetMessageBlock method 
Function 


Returns the name or index designated message block object of the WinCC AlarmControl as 
type "ICCAxMessageBlock". 
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Syntax 
Expression.GetMessageBlock (ByVal viIndex As Variant) 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 

Parameters 
VARIANT 
Parameters Description 
vindex Index or name of message block. 

Example 

"VBS316 

Dim ctrl 

Dim objMsgBlock 

Set ctrl = ScreenItems ("AlarmControl") 


Set objJMsgBlock = ctrl.GetMessageBlock ("Date") 
objMsgBlock.Align = 2 

Set objJMsgBlock = ctrl.GetMessageBlock ("Number") 
objMsgBlock.LeadingZeros = 4 


Note 


If you access the properties with the listing object, you do not have to enter the name of the 


listing. 


For the "MessageBlock" listing, for example, you write "objMsgBlock.Align" instead of 


"“objMsgBlock.MessageBlockAlign”. 


See also 
MessageBlock object (list) (Page 223) 


GetMessageBlockCollection method 


Function 


Returns the list of all message block objects of the WinCC AlarmControl as type 


"ICCAxCollection". 
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Syntax 

Expression.GetMessageBlockCollection () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


Features and functions of the ICCAxCollection 
The following properties are available for the ICCAxCollection: 
e Count 
e Item 
The following functions are available for the ICCAxCollection: 
e Addltem(vName) As Object 


@ Removeltem(vindex) 


Example 


'VBS317 

Dim ctrl 

Dim coll 

Dim msgblock 
Set ctrl = ScreenItems ("AlarmControl") 
Set coll = ctrl.GetMessageBlockCollection 
For Each msgblock In coll 

msgblock.Align = 1 
msgblock.Length = 12 
msgblock.Selected = TRUE 


Next 
Note 
If you access the properties with the listing object, you do not have to enter the name of the 
listing. 
For the "MessageBlock" listing, for example, you write "msgblock.Align" instead of 
"msgblock.MessageBlockAlign”. 

See also 


MessageBlock object (list) (Page 223) 
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GetMessageColumn method 


Function 
Returns the name or index designated column object of the WinCC AlarmControl as type 
"ICCAxMessageColumn". 
Syntax 
Expression.GetMessageColumn (ByVal viIndex As Variant) 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
VARIANT 
Parameters Description 
vindex Index or name of column in message list. 
Example 
'VBS318 
Dim ctrl 
Dim objMessColumn 
Set ctrl = ScreenItems ("AlarmControl") 
Set objMessColumn = ctrl.GetMessageColumn ("Date") 
objMessColumn.Visible = FALSE 
Set objMessColumn = ctrl.GetMessageColumn ("Number") 


objMessColumn.Sort = 1 


Note 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. 


For the "MessageColumn'" listing, for example, you write "objMessColumn.Visible" instead of 
"“objMessColumn.MessageColumnVisible". 


See also 
MessageColumn object (list) (Page 223) 
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GetMessageColumnCollection method 


Function 

Returns the list of all column objects of the WinCC AlarmControl as type "ICCAxCollection". 
Syntax 

Expression.GetMessageColumnCollection () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


Features and functions of the ICCAxCollection 
The following properties are available for the ICCAxCollection: 
e Count 
e Item 
The following functions are available for the |CCAxCollection: 
e Addltem(vName) As Object 


e Removeltem(vindex) 


Example 


"VBS319 

Dim ctrl 

Dim coll 

Dim msgcol 

Set ctrl = ScreenItems ("AlarmControl") 

Set coll = ctrl.GetMessageColumnCollection 

HMTRuntime.Trace "Number of message columns:" & coll.Count & vbCrLf 
For Each msgcol In coll 

HMIRuntime.Trace msgcol.Index & vbCrLf 
HMIRuntime.Trace msgcol.Name & vbCrLf 
HMTRuntime.Trace msgcol.Sort & vbCrLf 
HMTRuntime.Trace msgcol.SortIndex & vbCrLf 

Next 
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MessageColumn object (list) (Page 223) 


GetOperatorMessage method 


Function 


Syntax 


Parameters 


Example 


"VBS320 
Dim ctrl 


Dim objOpMess 
Set ctrl = 
Set objOpMess 


Returns the name or index designated operator message object of the WinCC AlarmControl 
as type "ICCAxOperatorMessage". 


Expression. GetOperatorMessage (ByVal viIndex As Variant) 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


VARIANT 
Parameters Description 
vindex Index or name of operator message 


ScreenlItems ("AlarmControl") 
= ctrl.GetOperatorMessage (0) 


objOpMess.Sourcel = "Number" 
objOpMess.SourceTypel = 1 


Note 
If you access the properties with the listing object, you do not have to enter the name of the 
listing. 


For the "OperatorMessage" listing, for example, you write "objOpMess.Source1" instead of 
"objOpMess.OperatorMessageSource1". 
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See also 
OperatorMessage object (list) (Page 224) 


GetOperatorMessageCollection method 


Function 
Returns the list of all operator message objects of the WinCC AlarmControl as type 
"ICCAxCollection". 
Syntax 
Expression.GetOperatorMessageCollection () 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


Features and functions of the ICCAxCollection 
The following properties are available for the |CCAxCollection: 
e Count 
e Item 
The following functions are available for the |CCAxCollection: 
e Addlitem(vName) As Object 


e Removeltem(vindex) 


Example 


"VBS321 

Dim ctrl 

Dim coll 

Dim opmsg 

Set ctrl = ScreenItems ("AlarmControl") 
Set coll = ctrl.GetOperatorMessageCollection 
For Each opmsg In coll 

HMIRuntime.Trace opmsg.Index & vbCrLf 
HMTRuntime.Trace opmsg.Name & vbCrLf 
HMIRuntime.Trace opmsg.Number & vbCrLf 
HMTRuntime.Trace opmsg.Selected & vbCrLf 

Next 
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See also 
OperatorMessage object (list) (Page 224) 
GetRow method 
Function 
Returns the row number designated row object of the table-based controls as type 
"ICCAxDataRow". 
Syntax 
Expression.GetRow (ByVal IRow As Long) 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
Long 
Parameters Description 
IRow Number of the desired line of the control. 
Example 
'VBS356 
Dim ctrl 


Dim lIndex 

Dim 1CellIndex 

Set ctrl = ScreenItems ("UAControl") 

Set coll = ctrl.GetRowCollection 

"enumerate and trace out row numbers 

For lIndex = 1 To coll.Count 

HMIRuntime.trace "Row: " & (ctrl.GetRow(lIndex) .RowNumber) & " " 
‘enumerate and trace out column titles and cell texts 

For 1CelliIndex = 1 To ctrl.GetRow (liIndex) .cCellCount 
HMIRuntime.Trace ctrl.GetRow(0).CellText(1CellIndex) & " " 
HMIRuntime.trace ctrl.GetRow(lIndex) .CellText(1CellIndex) & " m 
Next 

HMITRuntime.trace vbNewLin 

Next 
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See also 


Note 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. 


For the "Row" listing, for example, you write "objRow.CellCount" instead of 
"“objRow.RowCellCount". 


Row object (list) (Page 225) 


GetRowCollection method 


Function 


Syntax 


Parameters 


Returns the list of all row objects of the table-based controls type "ICCAxDataRowCollection". 


Expression.GetRowCollection () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


Properties of the ICCAxDataRowCollection 
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The ICCAxDataRowCollection refers to runtime data. The data is read-only. It is not possible 
to add and edit the data. 


The following properties are available for the ICCAxDataRowCollection: 
@ Count - Determines the number of rows in the collection. 


e@ Item - Access to an individual row within the collection via the row number. Numbering runs 
from 1 to Count. A Row object is returned. 
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Example 


'VBS357 

Dim ctrl 

Dim coll 

Dim lIndex 

Dim 1CellIndex 

Set ctrl = ScreenItems ("AlarmControl") 

Set coll = ctrl.GetRowCollection 

HMTIRuntime.Trace "Number of message rows:" & coll.Count & vbCrLf 

"enumerate and trace out row numbers 

For lIndex = 1 To coll.Count 

HMIRuntime.Trace "Row: " & (ctrl.GetRow(lIndex) .RowNumber) & " " 
‘enumerate and trace out column titles and cell texts 

For 1CellIndex = 1 To ctrl.GetRow(liIndex) .cCellCount 
HMIRuntime.Trace ctrl.GetMessageColumn (1CellIndex -1).Name & " 
HMIRuntime.Trace ctrl.GetRow(lIndex) .CellText(1CellIndex) & " u 


Next 
HMTRuntime.Trace vbNewLin 
Next 
See also 
Row object (list) (Page 225) 
GetRulerBlock method 
Function 
Returns the Block object designated as name or index of the WinCC RulerControl as type 
"ICCAxRulerBlock". 
Syntax 
Expression.GetRulerBlock (ByVal viIndex As Variant) 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


VARIANT 


vindex Index or name of block in RulerControl 
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Example 


"VBS322 
Dim ctrl 


Dim objRulerBlock 


Set ctrl = 


ScreenItems ("RulerControl") 


Set objRulerBlock = ctrl.GetRulerBlock (0) 
objRulerBlock.Caption = "RulerBlockl" 

Set objRulerBlock = ctrl.GetRulerBlock ("Name") 
objRulerBlock.Length = 10 


See also 


Note 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. 


For the "RulerBlock" listing, for example, you write "objRulerBlock.Caption" instead of 
“objRulerBlock.BlockCaption". 


RulerBlock object (list) (Page 226) 


GetRulerBlockCollection method 


Function 


Syntax 


Parameters 


Returns the list of all Block objects of the WinCC RulerControl as type "ICCAxCollection". 


Expression.GetRulerBlockCollection() 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


Features and functions of the ICCAxCollection 
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The following properties are available for the ICCAxCollection: 
@ Count 


e item 
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The following functions are available for the |CCAxCollection: 
e Addlitem(vName) As Object 


e Removeltem(vindex) 


Example 
'VBS323 
Dim ctrl 
Dim coll 
Dim rulerblock 
Set ctrl = ScreenItems ("RulerControl") 
Set coll = ctrl.GetRulerBlockCollection 
For Bach rulerblock In coll 
rulerblock.Align = 1 
rulerblock.Length = 12 


Next 
Note 
If you access the properties with the listing object, you do not have to enter the name of the 
listing. 
For the "RulerBlock" listing, for example, you write "rulerblock.Align” instead of 
"rulerblock.RulerBlockAlign”. 

See also 


RulerBlock object (list) (Page 226) 


GetRulerColumn method 


Function 


Returns the Column object designated as name or index of the WinCC RulerControl as type 
"ICCAxRulerColumn". 


Syntax 


Expression.GetRulerColumn (ByVal viIndex As Variant) 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
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Parameters 


Example 


"VBS324 
Dim ctrl 


Dim objRulercol 
ScreenItems ("RulerControl") 
Set objRulercol 
objRulercol.Sort = 0 
Set objRulercol 
objRulercol.Visible = FALSE 


Set ctrl = 


See also 


VARIANT 
vindex Index or name of column of RulerControl. 


= ctrl.GetRulerColumn ("Name") 


= ctrl.GetRulerColumn ("ValueY") 


Note 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. 


For the "RulerColumn" listing, for example, you write "objRulercol.Visible" instead of 
"objRulercol.ColumnvVisible". 


RulerColumn object (list) (Page 227) 


GetRulerColumnCollection method 


Function 


Syntax 


Parameters 
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Returns the list of all Column objects of the WinCC RulerControl as type "ICCAxCollection". 


Expression.GetRulerColumnCollection () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
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Features and functions of the ICCAxCollection 


Example 


"VBS 
Dim 
Dim 
Dim 
Set 
set 
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ctrl 

coll 
rulercol 
ctrl = Scre 
coll = ctrl 


The following properties are available for the ICCAxCollection: 
e Count 

e Item 

The following functions are available for the |CCAxCollection: 
e Addlitem(vName) As Object 


e Removeltem(vindex) 


enltems ("RulerControl") 
.GetRulerColumnCollection 


HMTRuntime.Trac 


For 
HMI 
HMI 
HMI 
HMI 

Next 


Each rulerc 
Runtime.Tra 
Runtime.Tra 
Runtime.Tra 
Runtime.Tra 


See also 


"Number of ruler columns:" & coll.Count & vbCrLf 
ol In coll 
ce rulercol.Index & vbCrLf 
ce rulercol.Name & vbCrLf 
ce rulercol.Sort & vbCrLf 
ce rulercol.SortIndex & vbCrLf 


RulerColumn object (list) (Page 227) 


GetRulerData method 


Function 


Syntax 


Returns the value of the called trend at the ruler position. 


Expression.GetRulerData (ByVal RulerIndex As Long, pvValue As 
Variant, Optional pvTimeStamp As Variant, Optional pvFlags As 
Varian) Long 

Expression 

Necessary. An expression which returns an object of the "Trend" type. 
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Parameters 
Parameters Description 
Rulerlndex 0 =Ruler 
pvValue Value of X axis 
pvTimeStamp Time or value of the Y axis 
pvFlags Qualitycode 

Example 

"VBS326 

Dim ctrl 


Dim objTrend 
Dim objIOFieldl 
Dim objIOField2 
Dim value 
Dim time 
Set ctrl = ScreenItems( "Controll" ) 
Set objTrend = ctrl.GetTrend( "Trend 1" ) 
Set objIOFieldl = ScreenItems( "I/O Fieldl" ) 
Set objIOField2 = ScreenItems( "I/O Field2" ) 
objTrend.GetRulerData 0, value, time 
obj 1IOField1.OutputValue = value 
obj 1TOField2.OutputValue = time 


GetSelectedRow method 


Function 
Returns the selected row object of the table-based controls as type "|CCAxDataRow". 


Syntax 

Expression.GetSelectedRow () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
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Example 


'VBS358 
Dim ctrl 
Dim 1CellIndex 
Dim 1CellCount 
Dim headingRow 
Dim selectedRow 
Set ctrl = ScreenItems ("TableControl") 
Set headingRow = ctrl.GetRow(0) 
Set selectedRow = ctrl.GetSelectedRow 
1CellCount = headingRow.CellCount 
‘enumerate and trace out column titles and cell texts 
For 1CellIndex = 1 To 1CellCount 
HMIRuntime.trace headingRow.CellText (lCellIndex) & ": i, 
HMIRuntime.trace selectedRow.CellText (1CelliIndex) 
HMTRuntime.trace vbNewLin 


Next 
Note 
If you access the properties with the listing object, you do not have to enter the name of the 
listing. 
For the "Row" listing, for example, you write "objRow.CellCount" instead of 
"“objRow.RowCellCount". 
See also 


Row object (list) (Page 225) 


GetSelectedRows method 


Function 


Returns the selected row objects of the table-based controls as type "ICCAxDataRow"for 
multiple selection. 


Syntax 


Expression. GetSelectedRows () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
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Parameters 


Example 


"VBS359 
Dim ctrl 
Dim 1CellIndex 
Dim 1CellCount 
Dim l1RowIndex 
Dim 1RowCount 
Dim headingRow 
Dim selectedRow 
Dim selectedRows 
Set ctrl = ScreenItems ("TableControl") 
Set headingRow = ctrl.GetRow(0) 
Set selectedRows = ctrl.GetSelectedRows 
1CellCount = headingRow.CellCount 
lRowCount = selectedRows.Count 
"enumerate selected rows 
For lRowIndex = 1 To lRowCount 
Set selectedRow = selectedRows (lRowIndex) 
HMIRuntime.Trace "Row number: " & CStr(lRowIndex) & vbNewLine 
‘enumerate and trace out column titles and cell texts 
For 1CellIndex = 1 To 1CellCount 
HMTRuntime.trace headingRow.CellText(1CellIndex) & ": a 
HMIRuntime.trace selectedRow.CellText (1CelliIndex) 
HMITRuntime.trace vbNewLin 


Next 
Next 
Note 
If you access the properties with the listing object, you do not have to enter the name of the 
listing. 
For the "Row" listing, for example, you write "objRow.CellCount" instead of 
“objRow.RowCellCount". 
See also 


Row object (list) (Page 225) 
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GetStatisticAreaColumn method 


Function 
Returns the name or index designated Column object of the WinCC RulerControl statistics 
area window as type "ICCAxRulerColumn". 
Syntax 
Ausdruck.GetStatisticAreaColumn (ByVal vindex As Variant) 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
VARIANT 
Parameters Description 
vindex Index or name of column of statistics area window. 
Example 
'VBS327 
Dim ctrl 
Dim objStatAreaCol 
Set ctrl = ScreenItems ("RulerControl") 


Set objStatAreaCol = ctrl.GetStatisticAreaColumn ("DatasourceY") 
objStatAreaCol.Visible = FALSE 
Set objStatAreaCol = ctrl.GetStatisticAreaColumn ("ValueY (LL) ") 
objStatAreaCol.Sort = 1 


Note 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. 


For the "StatisticAreaColumn" listing, for example, you write "objStatAreaCol.Visible" instead 
of "objStatAreaCol.ColumnVisible". 


See also 
StatisticAreaColumn object (list) (Page 228) 
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GetStatisticAreaColumnCollection method 


Function 


Syntax 


Parameters 


Returns the list of all column objects of the WinCC RulerControl statistics area window as type 
"ICCAxCollection". 


Ausdruck.GetStatisticAreaColumnCollection() 


Expression 


Necessary. An expression that returns an object of the "Screenltem" type. 


Features and functions of the ICCAxCollection 


Example 


"VBS 
Dim 
Dim 
Dim 
Set 
Set 
HMIR 
For 

HMI 
HMI 
HMI 
HMI 
Next 
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328 
ctrl 
coll 
statcol 
ctrl = 
coll = 


The following properties are available for the |CCAxCollection: 


Count 


Item 


The following functions are available for the ICCAxCollection: 
e@ Addlitem(vName) As Object 


Removeltem(vindex) 


ScreenlItems ("RulerControl") 
ctrl.GetStatisticAreaColumnCollection 


untime.Trac 


"Number of statistic 


Runtime. 
Runtime. 
Runtime. 
Runtime. 


= 


a 


[race 
[race 


Trace 


Trace 


Each statcol In coll 


Area columns:" & coll.Count & vbCrLf 


statcol.Index & vbCrLf 


statcol.Name & vbCrl 
statcol.Sort & vbCrl 
statcol.SortIndex & 


Lf 
Lf 
vbCrLf 
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See also 


7.14 VBS Reference 


StatisticAreaColumn object (list) (Page 228) 


GetStatisticResultColumn method 


Function 


Syntax 


Parameters 


Example 


"VBS329 
Dim ctrl 


Returns the name or index designated Column object of the WinCC RulerControl statistics 
window as type "ICCAxRulerColumn". 


Ausdruck.GetStatisticResultColumn (ByVal vindex As Variant) 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


VARIANT 
Parameters Description 
vindex Index or name of column of statistics window. 


Dim objStatResCol 


Set ctrl = 


ScreenItems ("RulerControl") 


Set objStatResCol = ctrl.GetStatisticResultColumn ("MaxValue") 


objStatResCol.Visible = FALSE 


Set objStatResCol = ctrl.GetStatisticResultColumn ("Average") 
objStatResCol.Sort = 2 


See also 


Note 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. 


For the "StatisticResultColumn" listing, for example, you write "objStatResCol.Visible" instead 
of "objStatResCol.ColumnVisible". 


StatisticResultColumn object (list) (Page 229) 
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GetStatisticResultColumnCollection method 


Function 


Syntax 


Parameters 


Returns the list of all Column objects of the WinCC RulerControl statistics window as type 
"ICCAxCollection". 


Ausdruck.GetStatisticResultColumnCollection () 


Expression 


Necessary. An expression that returns an object of the "Screenltem" type. 


Features and functions of the ICCAxCollection 


Example 


"VBS 
Dim 
Dim 
Dim 
Set 
Set 
HMIR 
For 

HMI 
HMI 
HMI 
HMI 
Next 
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330 
ctrl 
coll 
statcol 
ctrl = 
coll = 


The following properties are available for the ICCAxCollection: 


Count 


Item 


The following functions are available for the ICCAxCollection: 
e@ Addlitem(vName) As Object 


Removeltem(vindex) 


ScreenlItems ("RulerControl") 
ctrl.GetStatisticResultColumnCollection 


untime.Trac 


"Number of statistic 


Runtime. 
Runtime. 
Runtime. 
Runtime. 


= 


a 


[race 
[race 


Trace 


Trace 


Each statcol In coll 


result columns:" & coll.Count & vbCrLf 


statcol.Index & vbCrLf 


statcol.Name & vbCrl 
statcol.Sort & vbCrl 
statcol.SortIndex & 


Lf 
Lf 
vbCrLf 
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See also 
StatisticResultColumn object (list) (Page 229) 


GetStatusbarElement method 


Function 
Returns the element of the control status bar designated as name or index as type 
"ICCAxStatusbarElement". 

Syntax 
Ausdruck.GetStatusbarElement (ByVal viIndex As Variant) 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 

Parameters 
VARIANT 
Parameters Description 
vindex Index or name of status bar element. 

Example 

'VBS331 

Dim ctrl 

Dim objStatusBar 

Set ctrl = ScreenItems( "Controll" ) 


Set objStatusBar = ctrl.GetStatusbarElement (1) 
objStatusBar.Visible = FALSE 
Set objStatusBar = ctrl.GetStatusbarElement (3) 
objStatusBar.Width = 10 


Note 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. 


For the "StatusbarElement" listing, for example, you write "objStatusBar.Visible" instead of 
"“objStatusBar.StatusbarElementvVisible". 
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See also 
StatusbarElement object (list) (Page 229) 


GetStatusbarElementCollection method 


Function 

Returns the list of all status bar elements of the control as type "I|CCAxCollection". 
Syntax 

Ausdruck.GetStatusbarElementCollection () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


Features and functions of the ICCAxCollection 
The following properties are available for the |CCAxCollection: 
e Count 
e Item 
The following functions are available for the ICCAxCollection: 
e Addltem(vName) As Object 


e@ Removeltem(vindex) 


Example 


"VBS332 
Dim ctrl 
Dim coll 
Dim statelement 
Set ctrl = ScreenItems.Item("Controlli") 
Set coll = ctrl.GetStatusbarElementCollection 
HMIRuntime.Trace "Number of statusbar elements:" & coll.Count & vbCrLf 
For Each statelement In coll 
HMIRuntime.Trace statelement.Name & vbCrLf 
HMIRuntime.Trace statelement.Width & vbCrLf 
HMIRuntime.Trace statelement.Text & vbCrLf 
Next 
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See also 


7.14 VBS Reference 


Note 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. 


For the "StatusbarElement" listing, for example, you write "statelement.Name" instead of 
"statelement.StatusbarElementName". 


StatusbarElement object (list) (Page 229) 


GetTimeAxis method 


Function 


Syntax 


Parameters 


Returns the time axis object designated as name or index of the WinCC OnlineTrendControl 
as type "ICCAxTimeAxis". 


Ausdruck.GetTimeAxis (ByVal viIndex As Variant) 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


VARIANT 
Parameters Description 
vindex Index or name of time axis. 
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Example 


"'VBS333 


Dim 
Dim 
set 
Set 


objT 


Set 
obj 
obj 
obj 
obj 
obj 
obj 


ctrl 
objTimeAxis 


ctrl = ScreenItems ("OnlineTrendControl") 


objTimeAxis 


objTimeAxis 


imeAxis.Visible = FALSE 


= ctrl.GetTimeAxis (1) 


= ctrl.GetTimeAxis ("axis 2") 


TimeAxis.Label = "Time axis 2" 
TimeAxis.DateFormat = "dd.MM.yy" 
TimeAxis.TimeFormat = "HH:mm:ss.ms" 
TimeAxis.RangeType = 2 

TimeAxis.BeginTime = "06.04.2010 9:33:18" 


See also 


TimeAxis.MeasurePoints = 100 


Note 
If you access the properties with the listing object, you do not have to enter the name of the 
listing. 


For the "TimeAxis" listing, for example, you write "objTimeAx. Visible" instead of 
“objTimeAx. TimeAxisVisible". 


TimeAxis object (list) (Page 230) 


GetTimeAxisCollection method 


Function 


Syntax 


Parameters 
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Returns the list of all time axis objects of the WinCC OnlineTrendControl as type 
"ICCAxCollection". 


Ausdruck.GetTimeAxisCollection() 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
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Features and functions of the ICCAxCollection 
The following properties are available for the ICCAxCollection: 
e Count 
e Item 
The following functions are available for the |CCAxCollection: 
e Addltem(vName) As Object 


e Removeltem(vindex) 


Example 


"VBS 334 
Dim ctrl 
Dim objTrendWnd 

Dim objTimeAxisl 

Dim objTimeAxis2 

Dim objTrend 

Set ctrl = ScreenItems ("OnlineTrendControl") 

Set objTrendWnd = ctrl.GetTrendWindowCollection.AddItem("myWindow") 
Set objTimeAxisl = ctrl.GetTimeAxisCollection.AddItem("TimeAxis2010") 
Set objTimeAxis2 = ctrl.GetTimeAxisCollection.AddItem("TimeAxis2011") 
objTimeAxisl.TrendWindow = objTrendWnd.Name 


objTimeAxisl.Label = "2010" 
objTimeAxisl.RangeType = 1 
objTimeAxisl.BeginTime = "01.01.2010 0:00:00" 
objTimeAxisl.EndTime = "31.12.2010 11:59:59" 
objTimeAxis2.TrendWindow = objTrendWnd.Name 
objTimeAxis2.Label = "2011" 
objTimeAxis2.RangeType = 1 
objTimeAxis2.BeginTime = "01.01.2011 0:00:00" 
objTimeAxis2.EndTime = "31.12.2011 11:59:59" 


Set objTrend = ctrl.GetTrendCollection.AddItem("myTrendl") 
objTrend.TrendWindow = objTrendWnd.Name 
objTrend.TimeAxis = objTimeAxisl.Name 
Set objTrend = ctrl.GetTrendCollection.AddItem("myTrend2") 
objTrend.TrendWindow = objTrendWnd.Name 


objTrend.TimeAxis = objTimeAxis2.Name 


Note 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. 


For the "TimeAxis" listing, for example, you write "objTimeAxis1.Label" instead of 
"objTimeAxis1.TimeAxisLabel". 
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See also 


TimeAxis object (list) (Page 230) 


GetTimeColumn method 


Function 


Syntax 


Returns the time column object designated as name or index of the WinCC OnlineTableControl 
as type "ICCAxTimeColumn". 


Ausdruck.GetTimeColumn (ByVal vindex As Variant) 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


Parameters 


Example 


"'VBS335 


Dim 
Dim 
set 
Set 


objT 


Set 
obj 


ctrl 
TimeCol 


obj 


ctrl 
TimeCol = ctrl.GetTimeColumn ("Timecolumnl1") 
imeCol.ShowDate = FALSE 
TimeCol = ctrl.GetTimeColumn ("Timecolumn2") 


obj 


obj 


TimeCol.Visible = FALSE 


VARIANT 


Parameters Description 
vindex Index or name of time column. 


= ScreenlItems ("TableControl") 


Note 

If you access the properties with the listing object, you do not have to enter the name of the 
listing. 

For the "TimeColumn" listing, for example, you write "objTimeColumn.ShowDate" instead of 
"obj TimeColumn.TimeColumnShowDate". 


See also 


750 


TimeColumn object (list) (Page 231) 
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GetTimeColumnCollection method 


Function 
Returns the list of all time column objects of the WinCC OnlineTableControl as type 
"ICCAxCollection". 
Syntax 
Ausdruck.GetTimeColumnCollection () 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


Features and functions of the ICCAxCollection 
The following properties are available for the ICCAxCollection: 
e Count 
e Item 
The following functions are available for the |CCAxCollection: 
e Additem(vName) As Object 


e Removeltem(vindex) 
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Example 


"VBS336 


Dim ctrl 


m 


Dim obj 
Dim obj] 


Dim coll 


n 


Reference 


imeColl 
imeCol2 


Dim timecol 


Set ctrl 


objTimeCol 


objTimeCol 
objTimeCol 


= 


obj 


TimeCol 
objTimeCol 


objTimeCol 


= 


obj 


TimeCol 


= ScreenlItems ("TableControl") 

Set objTimeColl = ctrl.GetTimeColumnCollection.AddItem ("TimeColumn2010") 
Set objTimeCol2 = ctrl.GetTimeColumnCollection.AddItem("TimeColumn2011") 
objTimeColl.Caption = "2010" 

1.RangeType = 1 

1.BeginTime = "01.01.2010 0:00:00" 

1.EndTime = "31.12.2010 11:59:59" 

2.Caption = "2011" 

2.RangeType = 0 

2.BeginTime = "01.01.2011 0:00:00" 

2.TimeRangeFactor = 1 

2.TimeRangeBase = 3600000 


objTimeCol 


Set coll = ctrl.GetTimeColumnCollection 
For Each timecol In coll 

timecol.Align = 1 

timecol.Length = 12 

timecol.BackColor = RGB(240,240,0) 
timecol.ForeColor = RGB(130,160,255) 


Next 


See also 


TimeColumn object (list) (Page 231) 


GetToolbarButton method 


Function 


Syntax 


752 


Returns the name or index designated toolbar button function of the control as type 
"ICCAxToolbarButton". 


Ausdruck.GetToolbarButton (ByVal viIndex As Variant) 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
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Parameters 
VARIANT 
vindex Index or name of toolbar button function. 
Example 
"VBS337 
Dim ctrl 
Set ctrl = ScreenItems( "Controll" ) 


Dim toolbu 
Set toolbu = ctrl.GetToolbarButton ("ShowHelp") 


HMTRuntime.Trace "Name: " & toolbu.Name & vbCrLf 

HMTRuntime.Trace "Index: " & toolbu.Index & vbCrLf 

HMTRuntime.Trace "Hotkey: " & toolbu.HotKey & vbCrLf 
Note 
If you access the properties with the listing object, you do not have to enter the name of the 
listing. 


For the "ToolbarButton" listing, for example, you write "toolbu.Index" instead of 
"toolbu. ToolbarButtonIndex". 


See also 
ToolbarButton object (list) (Page 232) 


GetToolbarButtonCollection method 


Function 

Returns the list of all toolbar button functions of the control as type "ICCAxCollection". 
Syntax 

Ausdruck.GetToolbarButtonCollection () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
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Features and functions of the ICCAxCollection 


Example 


'VBS338 
Dim ctrl 
Dim coll 
Dim toolbu 


The following properties are available for the ICCAxCollection: 
@ Count 

e Item 

The following methods are available for the |CCAxCollection: 
e Addltem(vName) As Object 


@ Removeltem(vindex) 


Set ctrl = ScreenItems( "Controll" ) 
Set coll = ctrl.GetToolbarButtonCollection 
HMTRuntime.Trace "Number of toolbar buttons:" & coll.Count & vbCrLf 


For Each toolbu In coll 
HMITRuntime.Trace toolbu.Name & vbCrLf 


HMTRuntime.Trace "Hotkey: " & toolbu.HotKey & vbCrhf 
HMTRuntime.Trace "Authorization: " & toolbu.PasswordLevel & vbCrLf 
Next 
See also 


ToolbarButton object (list) (Page 232) 


GetTrend method 


Function 


Syntax 


754 


Returns the trend object designated as name or index of the WinCC OnlineTrendControl or 
WinCC FunctionTrendControl as type "I|CCAxTrena" or "ICCAxFunctionTrend". 


Ausdruck.GetTrend(ByVal viIndex As Variant) 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
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Parameters 
VARIANT 
vindex Index or name of curve. 

Example 

"VBS339 

Dim ctrl 

Dim objTrend 

Set ctrl = ScreenItems ("OnlineTrendControl") 


Set objTrend = ctrl.GetTrend( "Trend 1" ) 
objTrend.PointStyle = 1 
objTrend.LineWidth = 4 
Set objTrend = ctrl.GetTrend (2) 
objTrend.Provider = 1 

objTrend.TagName = "Archive\ArchiveTag2" 


Note 

If you access the properties with the listing object, you do not have to enter the name of the 
listing. 

For the "Trend" listing, for example, you write "objTrend.PointStyle" instead of 
"“objTrend.TrendPointStyle". 


See also 
Trend object (list) (Page 233) 


GetTrendCollection method 


Function 


Returns the list of all trend objects of the WinCC OnlineTrendControl or WinCC 
FunctionTrendControl as type "ICCAxCollection". 


Syntax 
Ausdruck.GetTrendCollection () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
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Parameters 


Features and functions of the ICCAxCollection 
The following properties are available for the |CCAxCollection: 
e Count 
e Item 
The following functions are available for the ICCAxCollection: 
e Addltem(vName) As Object 


e Removeltem(vindex) 


Example 


"VBS340 
Dim ctrl 
Dim objTrendWnd 
Dim objTimeAxis 
Dim objValAxis 
Dim objTrend 


Set ctrl = ScreenItems ("OnlineTrendControl") 
Set objTrendWnd = ctrl.GetTrendWindowCollection. AddItem ("myWindow") 
Set objTimeAxis = ctrl.GetTimeAxisCollection.AddItem ("myTimeAxis") 


Set objValAxis = ctrl.GetValueAxisCollection.AddItem ("myValueAxis") 
objTimeAxis.TrendWindow = objTrendWnd. Name 

objValAxis.TrendWindow = objTrendWnd.Name 

Set objTrend = ctrl.GetTrendCollection.AddItem("myTrendl") 


objTrend.Provider = 1 

objTrend.TagName = "Archive\ArchiveTagl" 
objTrend.TrendWindow = objTrendWnd.Name 
objTrend.TimeAxis = objTimeAxis.Name 


objTrend.ValueAxis = objValAxis.Name 


Note 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. 


For the "Trend" listing, for example, you write "objTrend.TagName" instead of 
"“objTrend. TrendTagName". 


See also 
Trend object (list) (Page 233) 
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GetTrendWindow method 


Function 


Returns the trend window object designated as name or index of the WinCC 
OnlineTrendControl or WinCC FunctionTrendControl as type "ICCAxTrendWindow". 


Syntax 
Ausdruck.GetTrendWindow (ByVal vindex As Variant) 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
VARIANT 
Parameters Description 
vindex Index or name of curve window. 
Example 
'VBS341 
Dim ctrl 
Dim objTrendWnd 
Set ctrl = ScreenItems ("OnlineTrendControl") 
Set objTrendWnd = ctrl.GetTrendWindow (1) 
objTrendWnd.Visible = FALSE 
Set objTrendWnd = ctrl.GetTrendWindow("trend window 2") 
objTrendWnd.VerticalGrid = TRUE 
objTrendWnd.FineGrid = TRUE 
Note 
If you access the properties with the listing object, you do not have to enter the name of the 
listing. 
For the "TrendWindow' listing, for example, you write "objTrendWnd. Visible" instead of 
“objTrendWnd. TrendWindowVisible". 
See also 


TrendWindow object (list) (Page 234) 
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GetTrendWindowCollection method 


Function 
Returns the list of all trend window objects of the WinCC OnlineTrendControl or WinCC 
FunctionTrendControl as type "ICCAxCollection". 
Syntax 
Ausdruck.GetTrendWindowCollection () 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


Features and functions of the ICCAxCollection 


The following properties are available for the ICCAxCollection: 
e Count 

e Item 

The following functions are available for the ICCAxCollection: 
e@ Addlitem(vName) As Object 


e Removeltem(vindex) 


Example 


"VBS342 


Dim 
Dim 
Dim 
Dim 
Set 
Set 
Set 
Set 


ctrl 
objTrendWnd 

objTimeAxis 

objValAxis 

ctrl = ScreenItems ("OnlineTrendControl") 

objTrendWnd = ctrl.GetTrendWindowCollection. AddItem ("myWindow") 
objTimeAxis = ctrl.GetTimeAxisCollection.AddItem("myTimeAxis") 
objValAxis = ctrl.GetValueAxisCollection.AddItem("myValueAxis") 


objTimeAxis.TrendWindow = objTrendWnd. Name 
objValAxis.TrendWindow = objTrendWnd.Name 


See also 
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GetValueAxis method 


Function 


Returns the value axis object designated as name or index of the WinCC OnlineTrendControl 
as type "ICCAxValueAxis". 


Syntax 
Ausdruck.GetValueAxis (ByVal viIndex As Variant) 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
VARIANT 
Parameters Description 
vindex Index or name of value axis. 
Example 
'VBS343 
Dim ctrl 
Dim objValAxis 
Set ctrl = ScreenItems ("OnlineTrendControl") 


Set objValAxis = ctrl.GetValueAxis (1) 
objValAxis.Visible = FALSE 
Set objValAxis = ctrl.GetValueAxis ("axis 2") 


objValAxis.Label = "Value axis 2" 
objValAxis.ScalingType = 0 
objValAxis.Precisions = 2 


objValAxis.AutoRange = TRUE 


Note 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. 


For the "ValueAxis" listing, for example, you write "objValueAx. Visible" instead of 
"objValueAx.ValueAxisVisible". 


See also 
ValueAxis object (list) (Page 235) 
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GetValueAxisCollection method 


Function 
Returns the list of all value axis objects of the WinCC OnlineTrendControl as type 
"ICCAxCollection". 
Syntax 
Ausdruck.GetValueAxisCollection () 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


Features and functions of the ICCAxCollection 
The following properties are available for the |CCAxCollection: 
e Count 
e Item 
The following functions are available for the ICCAxCollection: 
e Addltem(vName) As Object 


e Removeltem(vindex) 
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Example 


"VBS344 
Dim ctrl 
Dim objTrendWnd 

Dim objValAxisl 

Dim objValAxis2 

Dim objTrend 

Set ctrl = ScreenItems ("OnlineTrendControl") 

Set objTrendWnd = ctrl.GetTrendWindowCollection.AddItem("myWindow") 
Set objValAxisl = ctrl.GetValueAxisCollection.AddItem("myValueAxis1") 
Set objValAxis2 = ctrl.GetValueAxisCollection.AddItem("myValueAxis2") 
objValAxis1l.TrendWindow = objTrendWnd.Name 

objValAxisl.Label = "Valuel" 
objValAxis2.TrendWindow = objTrendWnd.Name 
objValAxis2.inTrendColor = TRUE 
Set objTrend = ctrl.GetTrendCollection.AddItem("myTrendl") 
objTrend.TrendWindow = objTrendWnd.Name 
objTrend.ValueAxis = objValAxisl.Name 
Set objTrend = ctrl.GetTrendCollection.AddItem("myTrend2") 
objTrend.TrendWindow = objTrendWnd.Name 
objTrend.ValueAxis = objValAxis2.Name 


Note 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. 


For the "ValueAxis" listing, for example, you write "objValueAxis1.Label" instead of 
“objValueAxis1.ValueAxisLabel". 


See also 
ValueAxis object (list) (Page 235) 


GetValueColumn method 


Function 


Returns the column object designated as name or index of the WinCC OnlineTableControl as 
type "ICCAxValueColumn". 


Syntax 
Ausdruck.GetValueColumn (ByVal vindex As Variant) 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
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Parameters 
VARIANT 
vindex Index or name of value column of OnlineTable- 
Control. 
Example 
"VBS345 
Dim ctrl 
Dim objValueColumn 
Set ctrl = ScreenlItems ("TableControl") 
Set objValueColumn = ctrl.GetValueColumn ("Valuecolumni") 
objValueColumn.Precisions = 4 
Set objValueColumn = ctrl.GetValueColumn (2) 
objValueColumn.ExponentialFormat = TRUE 
Note 
If you access the properties with the listing object, you do not have to enter the name of the 
listing. 
For the "ValueColumn'’ listing, for example, you write "objValueColumn.Precisions" instead of 
"objValueColumn.ValueColumnPrecisions". 
See also 


ValueColumn object (list) (Page 236) 


GetValueColumnCollection method 


Function 


Returns the list of all value column objects of the WinCC OnlineTableControl as type 
"ICCAxCollection". 


Syntax 


Ausdruck.GetValueColulmnCollection () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
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7.14 VBS Reference 


The following properties are available for the ICCAxCollection: 


@ Count 


e |tem 


The following functions are available for the |CCAxCollection: 


e Additem(vName) As Object 


e Removeltem(vindex) 


Example 


"VBS346 

Dim ctrl 

Dim objValColl 
Dim objValCol2 
Dim coll 
Dim valcol 
Set ctrl = ScreenItems ("TableControl") 


Set objValColl = ctrl.GetValueColumnCollection.AddItem("ValueColumnl") 
Set objValCol2 = ctrl.GetValueColumnCollection.AddItem("ValueColumn2") 


objValColl.Caption = "Value Archive" 
objValColl.Provider = 1 

objValColl.TagName = "ProcessValueArchive\archl1" 
objValColl.TimeColumn = "TimeColumnl" 
objValCol2.Caption = "Value Tag" 
objValCol2.Provider = 2 

objValCol2.TagName = "tagxx" 
objValCol2.TimeColumn = "TimeColumn2" 

Set coll = ctrl.GetValueColumnCollection 

For Each valcol In coll 


valcol.Align = 2 
valcol.Length = 10 
valcol.AutoPrecisions = TRUE 
Next 


See also 
ValueColumn object (list) (Page 236) 
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GetXAxis method 


Function 


Returns the X axis object designated as name or index of the WinCC FunctionTrendControl 
as type "ICCAxValueAxis". 


Syntax 
Ausdruck.GetXAxis (ByVal viIndex As Variant) 
Expression 
Required. An expression that returns an object of the "Screenltem" type. 
Parameters 
VARIANT 
Parameters Description 
vindex Index or name of X axis. 
Example 
"VBS347 
Dim ctrl 
Dim objXAx 
Set ctrl = ScreenItems ("FunctionTrendControl") 


Set objXAx = ctrl.GetXAxis (0) 
obj XAx.ScalingType = 0 


Set objXAx = ctrl.GetXAxis("X axis 1") 
objXAx.Label = "X2" 

obj XAx.Precisions = 2 

obj XAx.Color = RGB(109,109,109) 


Note 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. 


For the "XAxis" listing, for example, you write "objXAx. Visible" instead of "objXAx.XAxisVisible". 


See also 
XAxis object (list) (Page 237) 
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GetXAxisCollection method 


Function 
Returns the list of all X axis objects of the WinCC FunctionTrendControl as type 
"ICCAxCollection". 
Syntax 
Ausdruck.GetXAxisCollection () 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


Features and functions of the ICCAxCollection 
The following properties are available for the ICCAxCollection: 
e Count 
e Item 
The following functions are available for the |CCAxCollection: 
e Additem(vName) As Object 


e@ Removeltem(vindex) 


Example 


"VBS348 

Dim ctrl 

Dim objXAxisl 
Dim objXAxis2 


Dim coll 

Dim axes 

Set ctrl = ScreenItems ("FunctionTrendControl") 

Set objXAxisl = ctrl.GetXAxisCollection.AddItem("myXAxis1") 
objXAxisl.Label = "temperature" 

Set objXAxis2 = ctrl.GetXAxisCollection.AddItem("myXAxis2") 
objXAxis2.Label = "pressure" 


Set coll = ctrl.GetXAxisCollection 
HMIRuntime.Trace "Number of XAxis:" & coll.Count & vbCrLf 
For Each axes In coll 
HMIRuntime.Trace axes.Name & vbCrLf 
HMITRuntime.Trace axes.Label & vbCrLf 
Next 
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Note 


If you access the properties with the listing object, you do not have to enter the name of the 
listing. 


For the "XAxis" listing, for example, you write "objXAxis1.Label" instead of 
"objXAxis1.XAxisLabel". 


See also 
XAxis object (list) (Page 237) 
GetYAxis method 
Function 
Returns the Y axis object designated as name or index of the WinCC FunctionTrendControl 
as type "ICCAxValueAxis". 
Syntax 
Ausdruck.GetYAxis (ByVal viIndex As Variant) 
Expression 
Required. An expression that returns an object of the "Screenltem" type. 
Parameters 
VARIANT 
Parameters Description 
vindex Index or name of Y axis. 
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Example 


'VBS349 
Dim ctrl 
Dim objYAx 


Set ctrl = ScreenItems ("FunctionTrendControl") 
Set objJYAx = ctrl.GetYAxis (0) 

objJYAx.Align = 0 

obj YAx.Precisions = 3 


Set objJYAx = ctrl.GetYAxis("Y axis 1") 
obj YAx.Label = "Y1" 

Msgbox obj YAx.Label 

obj YAx.EndValue = 90 
objJYAx.BeginValue = 10 


7.14 VBS Reference 


Note 


If you access the properties with the listing object, you do not have to enter the name of the 


listing. 


For the "YAxis" listing, for example, you write "objYAx. Visible" instead of "objYAx. YAxisVisible". 


See also 
YAxis object (list) (Page 238) 


GetYAxisCollection method 


Returns the list of all Y axis objects of the WinCC FunctionTrendControl of type 


Necessary. An expression that returns an object of the "Screenltem" type. 


Function 
"ICCAxCollection". 

Syntax 
Ausdruck.GetYAxisCollection () 
Expression 

Parameters 
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Features and functions of the ICCAxCollection 


The following properties are available for the ICCAxCollection: 
@ Count 

e Item 

The following functions are available for the ICCAxCollection: 
e Addlitem(vName) As Object 


e Removeltem(vindex) 


Example 
'VBS350 
Dim ctrl 
Dim objYAxisl 
Dim objYAxis2 
Dim coll 
Dim axes 
Set ctrl = ScreenItems ("FunctionTrendControl") 
Set objJYAxisl = ctrl.GetXAxisCollection.AddItem("myYAxis1") 
objJYAxisl.Label = "temperature" 
Set objJYAxis2 = ctrl.GetXAxisCollection.AddItem("myYAxis2") 
objJYAxis2.Label = "pressure" 
Set coll = ctrl.GetYAxisCollection 
HMTRuntime.Trace "Number of YAxis:" & coll.Count & vbCrLf 
For Each axes In coll 
HMITRuntime.Trace axes.Name & vbCrLf 
HMITRuntime.Trace axes.Label & vbCrLf 
Next 
Note 
If you access the properties with the listing object, you do not have to enter the name of the 
listing. 
For the "YAxis" listing, for example, you write "objYAxis1.Label" instead of 
"objYAxis1.YAxisLabel". 
See also 
YAxis object (list) (Page 238) 
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Methods H to M 


HideAlarm method 


Function 


Syntax 


Parameters 


Executes the "Hide messages" key function of the AlarmControl. 


Expression.HideAlarm() 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


InsertData method 


Function 


Syntax 


Parameters 


Adds data to the called trend. 


Expression.InsertData(dblAxisX As Variant, dblAxisY As Variant) 


Expression 
Necessary. An expression which returns an object of the "Trend" type. 


Parameters Description 
dblAxisX Value of X axis 
dblAxisY Value of Y axis 
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Example 


"VBS300 

Dim IngFactor 

Dim dblAxisX 

Dim dblAxisY 

Dim objTrendControl 
Dim objTrend 


Set objTrendControl = ScreenItems("Controll") 
Set objTrend = objTrendControl.GetTrend("Trend 1") 
For lngFactor = -100 To 100 


dblAxisX = CDbl(lngFactor * 0.02) 

dblAxisY = CDbl1(dblAxisX * dblAxisX + 2 * dblAxisX + 1) 
objTrend.InsertData dblAxisX, dblAxisY 

Next 


Item Method 


Function 
Retrieves an object from a collection and enables access to it via Index. 


Description of Dataltem Object 


Access uses the name under which the value was added to the list. Single access using an 
index is not recommended since the index changes during adding or deleting of values. 


syntax 
Expression.Item() 
Expression 
Necessary. An expression which returns an object of the type "Screens", "Layers" (or "Tags"). 
Note 
In the case of "Tags", restricted functional scope! The standard methods get_Count and 
get_NewEnum are missing so that access via Index nor the counting of all tags is possible. 
Parameters 


VARIANT 


WinCC: Scripting (VBS, ANSI-C, VBA) 
770 System Manual, 02/2016, ASE37536061-AA 


VBS for Creating Procedures and Actions 


Example: 


7.14 VBS Reference 


The following example issues the names of all objects contained in the picture "NewPDL1": 


"VBS 99 

Dim objScreen 

Dim objScriItem 

Dim lngIndex 

Dim lngAnswer 

Dim strName 

IngIndex = 1 

Set objScreen = HMTRuntime.Screens ("NewPDL1") 

For IngIndex = 1 To objScreen.ScreenItems.Count 

' 

'The objects will be indicate by Item() 

strName = objScreen.ScreenItems.Item(lngIndex) .ObjectNam 
Set objScriItem = objScreen.ScreenItems (strName) 
IngAnswer = MsgBox (objScrItem.ObjectName, vbOKCancel) 
If vbCancel = lngAnswer Then Exit For 

Next 


See also 
Screenltems Object (List) (Page 129) 
Screenltem Object (Page 125) 
Tags Object (List) (Page 140) 
Alarms object (list) (Page 110) 
ProcessValues Object (List) (Page 124) 


LockAlarm method 


Function 

Executes the "Lock Alarm" key function of the AlarmControl. 
Syntax 

Expression. LockAlarm() 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
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LoopInAlarm method 


Function 
Executes the "Loop in Alarm" key function of the AlarmControl. 
Syntax 
Expression. LoopInAlarm() 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
MoveAxis method 
Function 
Executes the "Move axis" key function of the OnlineTrendControl and FunctionTrendControl. 
Syntax 
Expression.MoveAxis () 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
MoveRuler 
Function 
Moves the ruler from a specified reference point by a specified distance. 
Syntax 
Expression.MoveRuler( RulerIndex As Long, RulerMoveRef As Long, 
MoveDistance As Long, Optional vTrendWindow As Variant ) 
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Expression 
Required. An expression that returns an object of the "Screenltem" type. 


Parameter 
Parameter Description 
Rulerlndex Specifies the ruler to move: 
0 = Ruler 
1 = Ruler at the start of the statistics area 
2 = Ruler at the end of the statistics area 
RulerMoveRef Specifies the reference point as orientation for the third parameter "MoveDistance": 
0 = Time axis start position 
1 = Current ruler position 
2 = Time axis end position 
MoveDistance Number of pixels by which the ruler is moved away from reference point "RulerMoveRef". 
vTrendWindow Optional parameter for handling several, independent trend windows. 
Specifies the trend window in which the ruler is moved. The ruler moves in all trend windows 
if this parameter is not specified. 


Return value 
Function that returns the new ruler position. 


Example 


Table 1-1 Move ruler left by 10 pixels 


"VBS367 

Sub OnClick(ByVal Item) 

Dim ctrl 

Set ctrl = ScreenItems.Item("Controlli") 
call ctrl.MoveRuler (0, 1, -10) 

End Sub 


In the example, the ruler is moved by -10 pixels, starting at reference point 1 (current ruler 
position). The ruler is now positioned 10 pixels away from the left of its original position. 
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Example 


Table 1-2 Move ruler right by 10 pixels 


"VBS368 
Sub OnClick(ByVal Item) 


Dim ctrl 
Set ctrl = ScreenItems.Item("Controlli") 


ctrl.MoveRuler 0, 1, 10 
End Sub 


In the example, the ruler is moved by 10 pixels, starting at reference point 1 (current ruler 
position). The ruler is now positioned 10 pixels away from the right of its original position. 


Example 


Table 1-3 Move ruler to end on opening of the window 


"VBS369 
Sub OnOpen () 


Dim ctrl 
Set ctrl = ScreenItems.Item("Controli") 


ctrl.MoveRuler 0, 2, 0 
End Sub 


In the example, the ruler is moved by 0 pixels, starting at reference point 2 (time axis end 
position). The ruler is now positioned at the time axis end position. 


Example 


Table 1-4 Calculate current ruler position 


'VBS370 
Sub OnClick(ByVal Item) 


Dim ctrl 
Set ctrl = ScreenItems.Item("Controlli") 


Dim pos 
pos = ctrl.MoveRuler (0, 1, 0) 
HmiRuntime.Trace "RulerPosition=" & pos & vbCrLf 


End Sub 


In the example, the ruler is moved by 0 pixels, starting at reference point 1 (current ruler 
position). The ruler remains in its original position. The ruler position is returned as value. 
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MoveToFirst method 


Function 

Executes the "First line" key function of the control. 
Syntax 

Expression.MoveToFirst () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


MoveToFirstLine method 


Function 

Executes the "First message" key function of the AlarmControl. 
Syntax 

Ausdruck.MoveToFirstLine() 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


MoveToFirstPage method 


Function 
Executes the "First page" key function of the AlarmControl. 


Syntax 
Ausdruck.MoveToFirstPage () 
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Parameters 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


MoveToLast method 


Function 


Syntax 


Parameters 


Executes the "Last data record" key function of the control. 


Ausdruck.MoveToLast () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


MoveToLastLine method 


Function 


Syntax 


Parameters 


776 


Executes the "Last message" key function of the AlarmControl. 


Ausdruck.MoveToLastLine () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
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MoveToLastPage method 


Function 


Executes the "Last page" key function of the AlarmControl. 


Syntax 
Ausdruck.MoveToLastPage () 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
MoveToNext method 
Function 
Executes the "Next data record" key function of the control. 
Syntax 
Ausdruck.MoveToNext () 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
MoveToNextLine method 
Function 
Executes the "Next message" key function of the AlarmControl. 
Syntax 


Ausdruck.MoveToNextLine () 
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Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


Parameters 
MoveToNextPage method 
Function 
Executes the "Next page" key function of the AlarmControl. 
Syntax 
Ausdruck.MoveToNextPage () 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


MoveToPrevious method 


Function 

Executes the "Previous data record" key function of the control. 
Syntax 

Ausdruck.MoveToPrevious () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
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MoveToPreviousLine method 


Function 

Executes the "Previous message" key function of the AlarmControl. 
Syntax 

Ausdruck.MoveToPreviousLine () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


MoveToPreviousPage method 


Function 

Executes the "Previous page" key function of the AlarmControl. 
syntax 

Ausdruck.MoveToPreviousPage () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


1.14.5.5 Methods N to R 


NextColumn method 


Function 
Executes the "Next column" key function of the OnlineTableControl. 
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Syntax 


Parameters 


Ausdruck.NextColumn () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


NextTrend method 


Function 

Executes the "Next curve" key function of the OnlineTrendControl and FunctionTrendControl. 
Syntax 

Ausdruck.NextTrend () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
OneToOneView method 
Function 

Executes the "Original view" key function of the OnlineTrendControl and FunctionTrendControl. 
Syntax 

Ausdruck.OneToOneView () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 

VARIANT 
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PasteRows method 


Function 

Executes the "Paste Rows" key function of the UserArchiveControl. 
Syntax 

Expression. PasteRows () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


PreviousColumn method 


Function 

Executes the "Previous column" key function of the OnlineTableControl. 
Syntax 

Ausdruck.PreviousColumn () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


PreviousTrend method 


Function 


Executes the "Previous curve" key function of the OnlineTrendControl and 
FunctionTrendControl. 


Syntax 


Ausdruck. PreviousTrend() 
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Parameters 


Print method 


Function 


Syntax 


Parameters 


QuitHorn method 


Function 


Syntax 


Parameters 


782 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


Executes the "Print" key function of the control. 


Ausdruck. Print () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


Executes the "Acknowledge central signaling devices" key function of the AlarmControl. 


Ausdruck.QuitHorn () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
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QuitSelected method 


Function 

Executes the "Single acknowledgment" key function of the AlarmControl. 
Syntax 

Ausdruck.QuitSelected () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
QuitVisible method 
Function 

Executes the "Group acknowledgment" key function of the AlarmControl. 
Syntax 

Ausdruck.QuitVisible() 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


Read Method 


Description of Tag Object 


Reads out the status of a tag (tag object) shortly after the moment it was called. At the same 
time, the tag object is provided with the values read. Upon reading a tag, its value, quality code 
and time stamp are determined. The "LastError" property can be used to determine whether 
the call was successful. 


The "Name", "ServerPrefix" and "TagPrefix" properties are not changed as a result. 
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syntax 


Parameters 


784 


If the value of the tag is read successfully, the properties of the tag object are assigned the 
following values: 


Property Assignment 

Value Tag values 

Name Tag name (unchanged) 
QualityCode Quality level 
Timestamp Current tag time stamp 
LastError 0 

ErrorDescription a 


If the value of the tag is not read successfully, the properties of the tag object are assigned 
the following values: 


Property Allocation 

Value VT_Empty 

Name Tag name (unchanged) 
QualityCode Bad Out of Service 
Timestamp 0 

LastError Read operation error codes 
ErrorDescription Error description on LastError 
Note 


A summary of possible Quality Codes may be found in WinCC Information System under key 
word "Communication" > "Diagnostics" or "Communication" > "Quality Codes". 


Expression. Read ([Readmode] ) 


Expression 


Necessary. An expression which returns a tag object. The return value of the Read method is 
the value of the tag read out. 


The optional "Readmode" parameter enables the distinction between two types of reading: 


Parameters Description 

0 The tag value is read from the process image 
(cache). 0 is the default value. 

1 The value of a tag is read directly from AS or chan- 
nel (direct). 
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If the "Readmode" parameter is omitted, the value is read from the process image by default. 
The return value of the Read method is the tag value read out as VARIANT. 


Reading From the Process Image 


When reading from the process image, the tag is logged on and, from that moment, polled 
cyclically from the PLC. The login cycle is dependent on the configured trigger. The value is 
read from the tag image by WinCC. For Close Picture, the tag actions are ended again. The 
call is characterized by the following: 


@ The value is read by WinCC from the tag image. 


e The call is faster in comparison to direct reading (except with the first call: The first call 
basically takes longer because the value from the PLC must be read out and logged on.) 


e The duration of the call is not dependent on the bus load or AS. 


Behavior in actions with a tag trigger 


All of the tags contained in the tag trigger are already known with Open Picture and are 
registered with the defined monitoring time. Since all tags are requested at once, the best 
possible optimization can be targeted from the channel. If a tag, contained in the trigger, is 
requested with Read during an action, the value already exists and is transferred directly to 
the call. If a tag is requested which is not contained in the trigger, the behavior is the same as 
with a standard trigger. 


Behavior in actions with a cyclic trigger 
tags are registered with half of the cycle time with the first call. For every other call, the value 
is present. 


Behavior in event-driven actions 


The tag is registered in the "upon change" mode with the first call. Process tags that are 
registered in the "upon change" mode correspond with a cyclic read job with a cycle time of 
1s. 


If an event (e.g. mouse click) requests a value asynchronously, the tag is transferred to the 
tag image. The tag is requested cyclically from the AS as of this point in time and therefore 
increases the basic load. To bypass this increase in the basic load, the value can also be read 
synchronously. The synchronous call causes a one-off increase in the communication load 
but the tag is not transferred to the tag image. 


Direct reading 


In the case of direct reading, the current value is returned. The tag is not registered cyclically, 
the value is requested from the AS one time only. Direct reading has the following properties: 


e The value is read explicitly from the AS. 
e The call takes longer compared to reading from the process image. 


e The duration of the call is dependent on the bus load and AS, amongst other things. 
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Example: 


Reading a tag directly from AS or channel 


"'VBS100 

Dim objTag 

Dim vntValue 

Set objTag = HMIRuntime.Tags ("Tagname") 
vntValue = objTag.Read (1) "Read direct 
MsgBox vntValue 


Reading a tag from the process image 


"VBS101 

Dim objTag 

Dim vntValue 

Set objTag = HMIRuntime.Tags ("Tagname") 
vntValue = objTag.Read "Read from cache 
MsgBox vntValue 


Description of TagSet Object 
The TagSet object offers the option of reading several tags in one call. 
Functionality here is mostly identical with that of a tag object. In the following, only deviations 
thereof are described. 


Expression 
Necessary. An expression which returns an object of type "TagSet". 


Reading From the Process Image 
The TagSet object offers the advantage of requesting several tags in one read command. The 
tags are registered in the process image as a group, improving performance in the process. 


Direct reading 
Since one call may process several read commands, performance is enhanced in comparison 


to single calls. 
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Example: 


The following example shows how tags are included in the TagSet list, how tag values are 
imported and subsequently read. 


'VBS174 

Dim group 

Set group = HMIRuntime.Tags.CreateTagSet 

group.Add "Motor1" 

group.Add "Motor2" 

group.Read 

HMIRuntime.Trace "Motorl: " & group("Motorl1").Value & vbNewLine 
HMTIRuntime.Trace "Motor2: " & group("Motor2").Value & vbNewLine 


If the optional parameter "Readmode" is set to 1, the process tags are not registered but read 
directly from AS or channel. 


group.Read 1 


See also 
Example: How to Read Tag Values (Page 830) 
Example: Writing tag values (Page 828) 
LastError Property (Page 459) 
ErrorDescription Property (Page 411) 
TagSet Object (List) (Page 141) 
Tag Object (Page 137) 
Read Tags method 
Function 
Executes the "Read tags" key function of the UserArchiveControl. 
Syntax 


Ausdruck.ReadTags () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
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Parameters 


Refresh Method 


Function 
Drawing all visible pictures again. 
syntax 
Expression.Refresh 
Expression 
Necessary. An expression which returns a "Screens" or "Screen" type object. 
Parameters 
Examples 
The first example forces all visible pictures to be drawn again: 
"VBS149 


HMTRuntime.Screens.Refresh 


The second example forces the basic picture to be immediately redrawn: 


"VBS150 
HMIRuntime.Screens (1) .Refresh 


See also 
Screen Object (Page 131) 
Screens Object (List) (Page 134) 
HM IRuntime Object (Page 118) 
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Remove Method 


Description of TagSet Object 


Removes a tag from the TagSet list. The tag may be removed by name or reference to a tag 
object. 


syntax 
Expression.Remove [Tag] 
Expression 
Necessary. An expression which returns an object of type "TagSet". 
Parameters 
VARIANT 
Parameters Description 
Tag Name of a WinCC tag or reference to a tag object 
to be removed from the list. 
Example: 
The following example shows how several tags are included in the TagSet list, and how to 
remove a tag again. 
'VBS175 


Dim group 

Set group = HMIRuntime.Tags.CreateTagSet 
group.Add "Motor1" 

group.Add "Motor2" 

group.Remove "Motor1" 


Description of DataSet Object 
Deletes the element specified in parameter "Name" from a list. 


syntax 


Expression.Remove [Name] 


Expression 
Necessary. An expression which returns an object of type "DataSet". 
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Parameters 


Example: 


"'VBS166 


VARIANT 
Name Name of the object to be removed from the list. 


The example shows how to remove the object "motor1" from the list. 


HMIRuntime.DataSet.Remove ("motor1") 


Description of objects Logging, AlarmLogs, DataLogs 


syntax 


Object DataLogs 


790 


The method deletes a previously swapped archive segment from the Runtime project. 


Archive segments deleted with the "Remove" method are removed from the common archiving 
directory of the project. 


The call may require a somewhat longer time period, depending on archive data. This may 
block the processing of subsequent scripts. Blockage of actions within the picture may be 
avoided if you start the call in a Global Scripting action, such as starting the action through a 
triggering tag. 


The archive separation and deletion creates a CPU load. This will affect performance. 


Note 


Calling up the "Remove" method is presently only possible at the server. There is an example, 
however, which shows how the method may be started by the client from a server. 


For redundancy, the following applies: Re-swapped archives are deleted with the "Remove" 
method only on the computer from which the method was initiated. 


Objects Logging, AlarmLogs 


Expression.Remove [TimeFrom] [TimeTo] [TimeOut] [ServerPrefix] 


Expression 


Necessary. An expression which returns an object of type "Logging" or "AlarmLogs". 


Expression.Remove [TimeFrom] [TimeTo] [TimeOut] [Type] [ServerPrefix] 
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Expression 
Necessary. An expression which returns an object of type "DataLogs". 


TimeFrom 


Point in time, from which the archives are to be deleted. 
When indicating the time format, a short form is also possible. This is described in the "Time 
Format" section. 


TimeTo 


Time up to which archive segments are to be deleted. 
When indicating the time format, a short form is also possible. This is described in the "Time 
Format" section. 


Timeout 


Timeout in milliseconds. 
If you enter "-1" as a value, the wait will be infinite. If you enter a value of "0", there will be no 
wait. 


Type: 


Type of archive. 
The parameter can (optionally) be used only to delete archive segments of the tag logging. 
The following values can be entered: 


Assigned Value Type Description 

1 hmiDataLogFast Tag Logging Fast data 

2 hmiDataLogSlow Tag Logging Slow data 

3 hmiDataLogAll Tag Logging Fast and Slow data 
ServerPrefix 


Reserved for future versions. 


If an error occurred during deletion of the archive segments, the method will return an error 
message. Additional information may be found under the subject heading "Error Messages 
from Database Area". 


Time format is defined as follows: YYYY-MM-DD hh:mm:ss, where YYYY represents the year, 
MM the month, DD the day, hh the hour, mm the minute and ss the second. For example, the 
time of 2 minutes and one second past 11 o'clock on July 26, 2004 is displayed as follows: 
2004-07-26 11:02:01. 


For parameters "TimeFrom" and "TimeTo" the statement of data and time is also possible in 
short form. Not all format fields must be filled in this case. The short form means that the 
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information on date and time may be lacking one or several parameters, beginning with the 
value for seconds. For example, the statement may be in the form of "YYYY-MM" or "YYYY- 
MM-DD hh". Using the statement "TimeFrom" = "2004-09" and "TimeTo" = "2004-10-04" all 
archive segments between September 2004 up to and including October 4th are to be 
swapped. 


Example: 
In the following example, archive segments re-swapped after the fact for a specified time period 
may be removed and the return value may be output as Trace. 
'VBS182 
HMIRuntime.Trace "Ret: " & HMIRuntime. Logging. Remove ("2004-08-22","2004-09-22",-1) & 
vbNewLine 
In the following example, all archive segments re-swapped after the fact may be removed and 
the return value may be output as Trace. 
'VBS183 
HMIRuntime.Trace "Ret: " & HMIRuntime.Logging.Remove("","",-1) & vbNewLine 
See also 


Error Messages from Database Area (Page 820) 

Example: How to Start an Action on the Server (Logging Object) (Page 836) 
Logging Object (Page 122) 

DataSet Object (List) (Page 116) 

DataLogs Object (Page 114) 

AlarmLogs Object (Page 112) 

TagSet Object (List) (Page 141) 


RemoveAll Method 


Description of TagSet Object 
Deletes all tags from a TagSet list. 


syntax 


Expression. RemoveAll 
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Expression 
Necessary. An expression which returns an object of type "TagSet". 


Parameters 
Example: 
The following example shows how several tags are included in the TagSet list, and how to 
remove all tags again. 
"'VBS176 


Dim group 

Set group = HMIRuntime.Tags.CreateTagSet 
group.Add "Motor1" 

group.Add "Motor2" 

group.RemoveAl1l 


Description of DataSet Object 
Deletes all values or object references from a DataSet list. 


syntax 

Expression. RemoveAll 

Expression 

Necessary. An expression which returns an object of type "DataSet". 
Parameters 
Example: 

The example shows how all objects are removed from the list. 

"VBS167 


HMTRuntime.DataSet.RemoveAll 
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See also 


DataSet Object (List) (Page 116) 
TagSet Object (List) (Page 141) 
Tag Object (Page 137) 


RemoveData method 


Function 


Syntax 


Example 


'VBS310 
Dim objT 
Dim objT 
Set objT 
Set objT 


Deletes the data of the called trend. 
Expression.RemoveData 
Expression 
Necessary. An expression which returns an object of the "Trend" type. 
rendcControl 
rend 
rendControl = ScreenItems ("Controlli") 
rend = objTrendControl.GetTrend("Trend 1") 


objTrend.RemoveData 


Restore Method 


Description of objects Logging, AlarmLogs, DataLogs 


794 


The method adds swapped archive segments to the Runtime project. 


Upon swapping, the archive segments are copied to the common archiving directory of the 
project. Therefore, the appropriate storage capacity must be available. 


The call may require a somewhat longer time period, depending on archive data. This may 
block the processing of subsequent scripts. Blockage of actions within the picture may be 
avoided if you start the call in a Global Scripting action, such as starting the action through a 
triggering tag. 

Linking / copying of the archives generates a CPU load because the SQL server experiences 
additional load because of turned-on signature checking in particular. Copying of archive 
segments will slow down hard disk access. 
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Upon turned-on signature checking, an error message is returned if an unsigned or modified 
archive is to be swapped. There is always only one error message returned, even if several 
errors occurred during the swap process. Additionally, a WinCC system message is generated 
for each archive segment. An entry is added to the Windows event log in the "Application" 
section. This provides the opportunity to check which archive segments are creating the error. 


e With an unsigned archive, the return value "0x8004720F" is returned. The archive is stored. 
The following text is entered in the event display: 
"Validation of database <db_name> failed! No signature found!" 


e With an changed archive, the return value "0x80047207" is returned. The even screen, the 
entry is "Validation of database <db_name> failed !". 
The archive is not stored. 


Note 


Calling up the "Restore" method is presently only possible at the server. There is an 
example, however, which shows how the method may be started by the client from a server. 


For redundancy, the following applies: Upon re-swapping of archives with the "Restore" 
method, only archive segments are added to the Runtime project on the computer from 
which the method was called. 


Syntax 
Objects Logging, AlarmLogs 
Expression.Restore [SourcePath] [TimeFrom] [TimeTo] [TimeOut] 
[ServerPrefix] 
Expression 
Required. An expression which returns an object of type "Logging" or "AlarmLogs". 
Object DataLogs 
Expression.Restore [SourcePath] [TimeFrom] [TimeTo] [TimeOut] [Type] 
[ServerPrefix] 
Expression 
Required. An expression which returns an object of type "DataLogs". 
Parameter 


SourcePath 
Path to archive data. 
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Return value 


Time format 


796 


TimeFrom 


Point in time, from which the archives are to be stored. 
When indicating the time format, a short form is also possible. This is described in the "Time 
Format" section. 


TimeTo 


Time up to which archive segments are to be swapped. 
When indicating the time format, a short form is also possible. This is described in the "Time 
Format" section. 


Timeout 


Timeout in milliseconds. 
If you enter "-1" as a value, the wait will be infinite. If you enter a value of "0", there will be no 
wait. 


Type 

Type of archive. 

The parameter can (optionally) be used only to store archive segments of the tag logging. 
The following values can be entered: 


Assigned Value Type Description 

1 hmiDataLogFast Tag Logging Fast data 

2 hmiDataLogSlow Tag Logging Slow data 

3 hmiDataLogAIll Tag Logging Fast and Slow data 
ServerPrefix 


Reserved for future versions. 


If an error occurred during swapping of archive segments, the method will return an error 
message. Additional information may be found under the subject heading "Error Messages 
from Database Area". 


Time format is defined as follows: YYYY-MM-DD hh:mm:ss, where YYYY represents the year, 
MM the month, DD the day, hh the hour, mm the minute and ss the second. For example, the 
time of 2 minutes and one second past 11 o'clock on July 26, 2004 is displayed as follows: 
2004-07-26 11:02:01. 


For parameters "TimeFrom" and "TimeTo" the statement of data and time is also possible in 
short form. Not all format fields must be filled in this case. The short form means that the 
information on date and time may be lacking one or several parameters, beginning with the 
value for seconds. For example, the statement may be in the form of "YYYY-MM" or "YYYY- 
MM-DD hh". Using the statement "TimeFrom" = "2004-09" and "TimeTo" = "2004-10-04" all 
archive segments between September 2004 up to and including October 4th are to be 
swapped. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


VBS for Creating Procedures and Actions 
7.14 VBS Reference 


Example 
In the following example, all archive segments since the specified time period are re-swapped, 
and the return value is output as Trace. 
'VBS184 
HMTRuntime.Trace "Ret: " & HMIRuntime.Logging.Restore("D:\Folder","2004-09-14","",-1) & 
vbNewLine 
In the following example, all Tag Logging Slow archive segments since the specified time 
period are re-swapped, and the return value is output as Trace. 
'VBS185 
HMTRuntime.Trace "Ret: " & HMIRuntime.Logging.DataLogs.Restore ("D:\Folder","2004-09-14 


12:30:05","2004-09-20 18:30",-1,2) & vbNewLine 


In the following example, all Alarm Logging archive segments up to the specified time period 
are re-swapped, and the return value is output as Trace. 


'VBS186 
HMTIRuntime.Trace "Ret: " & HMIRuntime.Logging.AlarmLogs.Restore("","2004-09-20",-1) & 


vbNewLine 


See also 
Error Messages from Database Area (Page 820) 
Example: How to Start an Action on the Server (Logging Object) (Page 836) 
Logging Object (Page 122) 
DataLogs Object (Page 114) 
AlarmLogs Object (Page 112) 


1.14.5.6 Methods S to T 


SelectAll 


Function 
Selects all rows in the table-based control. 
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Syntax 

Expression.SelectAll () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
See also 

Row object (list) (Page 225) 
SelectRow 
Function 

Selects a particular row in the table-based control. 
Syntax 

Expression.SelectRow (ByVal IRow As Long, Optional bExtendSelection 

As Boolean) 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 

Parameters Description 
Number of the row to be selected. 
bExtendSelection | Indicates as an option whether the current selection will be extended. Is only rel- 
evant if multiple selections are possible. 

Example 

e Row 1 is currently selected. If SelectRow( 2, True ) is called, then row 1 and row 2 will be 

selected. 
e Row 1 is currently selected. If SelectRow( 2, False ) or SelectRow( 2 ) is called without an 
optional parameter, then only row 2 will be selected. 

See also 

Row object (list) (Page 225) 
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SelectedStatisticArea method 


Function 

Executes the "Set statistic area" key function of the OnlineTableControl. 
Syntax 

Ausdruck.SelectedStatisticArea () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


ServerExport method 


Function 

Executes the "Export archive" key function of the UserArchiveControl. 
Syntax 

Ausdruck.ServerExport () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


Serverlmport method 


Function 


Executes the "Import archive" key function of the UserArchiveControl. 


Syntax 


Ausdruck.ServerImport () 
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Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


Parameters 


ShowColumnSelection method 


Function 

Executes the "Select columns" key function of the OnlineTableControl. 
Syntax 

Ausdruck.ShowColumnSelection () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


ShowComment method 


Function 

Executes the "Comments dialog” key function of the AlarmControl. 
Syntax 

Ausdruck.ShowComment () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
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ShowDisplayOptionsDialog method 


Function 

Executes the "Display options dialog" key function of the AlarmControl. 
Syntax 

Ausdruck.ShowDisplayOptionsDialog() 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


ShowEmergencyQuitDialog method 


Function 

Executes the "Emergency acknowledgment" key function of the AlarmControl. 
Syntax 

Ausdruck.ShowEmergencyQuitDialog() 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
ShowHelp method 
Function 

Executes the "Help" key function of the control. 
Syntax 


Ausdruck.ShowHelp () 
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Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


Parameters 

VARIANT 
ShowHideList method 
Function 

Executes the "List of messages to be hidden" key function of the AlarmControl. 
Syntax 

Ausdruck.ShowHideList () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
ShowHitList method 
Function 

Executes the "Hitlist" key function of the AlarmControl. 
Syntax 

Ausdruck.ShowHitList () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
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ShowlnfoText method 


Function 


Syntax 


Parameters 


Executes the "Info text dialog" key function of the AlarmControl. 


Ausdruck.ShowInfoText () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


ShowinsertValueDialog method 


Function 


Syntax 


Executes the "Create archive value" key function of the OnlineTableControl. 


Expression. ShowInsertValueDialog() 


Expression 
Required. An expression that returns an object of the "Screenltem" type. 


ShowLockDialog method 


Function 


Syntax 


Executes the "Lock dialog" key function of the AlarmControl. 


Ausdruck.ShowLockDialog() 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
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Parameters 
ShowLockList method 
Function 
Executes the "Lock list" key function of the AlarmControl. 
Syntax 
Ausdruck.ShowLockList () 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


ShowLongTermArchiveList method 


Function 


Syntax 


Parameters 


Executes the "Long-term archive list" key function of the AlarmControl. 


Ausdruck.ShowLongTermArchiveList () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


ShowMessageList method 


Function 


804 


Executes the "Message list" key function of the AlarmControl. 
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Ausdruck.ShowMessageList () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


ShowPercentageAxis method 


Function 


Syntax 


Parameters 


Executes the "Relative axis" key function of the OnlineTrendControl. 


Ausdruck.ShowPercentageAxis () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


ShowPropertyDialog method 


Function 


Syntax 


Parameters 


Executes the "Configuration dialog" key function of the control. 


Ausdruck.ShowPropertyDialog() 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


VARIANT 
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ShowSelectArchive method 


Function 

Executes the "Select data connection" key function of the UserArchiveControl. 
Syntax 

Ausdruck.ShowSelectArchive () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


ShowSelection method 


Function 

Executes the "Selection dialog" key function of the UserArchiveControl. 
Syntax 

Ausdruck.ShowSelection () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


ShowSelectTimeBase method 


Function 
Executes the "Time base dialog" key function of the UserArchiveControl. 


Syntax 


Ausdruck.ShowSelectTimeBase () 
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Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


ShowSelectionDialog method 


Function 


Syntax 


Parameters 


Executes the "Selection dialog" key function of the AlarmControl. 


Ausdruck.ShowSelectionDialog() 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


ShowShortTermArchiveList method 


Function 


Syntax 


Parameters 


Executes the "Short-term archive list" key function of the AlarmControl. 


Ausdruck.ShowShortTermArchiveList () 


Expression 


Necessary. An expression that returns an object of the "Screenltem" type. 
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ShowSort method 


Function 


Syntax 


Parameters 


Executes the "Sort dialog" key function of the UserArchiveControl. 


Ausdruck.ShowSort () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


ShowSortDialog method 


Function 


Syntax 


Parameters 


Executes the "Sort dialog" key function of the AlarmControl. 


Ausdruck.ShowSortDialog() 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


ShowTagSelection method 


Function 


Syntax 
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Executes the "Select data connection" key function of the control. 


Ausdruck.ShowTagSelection () 
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Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


ShowTimebaseDialog method 


Function 


Syntax 


Parameters 


Executes the "Time base dialog" key function of the AlarmControl. 


Ausdruck.ShowTimebaseDialog () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


ShowTimeSelection method 


Function 


Syntax 


Parameters 


Executes the "Select time range" key function of the control. 


Ausdruck.ShowTimeSelection () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
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ShowTrendSelection method 


Function 
Executes the "Select trends" key function of the OnlineTrendControl and 
FunctionTrendControl. 
Syntax 
Ausdruck.ShowTrendSelection () 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
StartStopUpdate method 
Function 
Executes the "Start" or "Stop" key function of the control. 
Syntax 
Ausdruck.StartStopUpdate () 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
Stop Method 
Function 
Terminates WinCC Runtime. 
syntax 


HMTRuntime.Stop 
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Parameters 


Example: 


The following example terminates WinCC Runtime: 


"VBS124 
HMTRuntime.Stop 


See also 
HM IRuntime Object (Page 118) 
Trace Method 
Description 
Displays messages in the diagnostics window. 
syntax 
HMIRuntime.Trace 
Parameters 
STRING 
Example: 
The following example writes a text in the diagnostics window: 
"'VBS103 


HMIRuntime.Trace "Customized error message" 


See also 
HM IRuntime Object (Page 118) 
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1.14.5.7 


Methods U to Z 


UnhideAlarm method 


Function 


Syntax 


Parameters 


Executes the "Unhide alarm" key function of the AlarmControl. 


Ausdruck.UnhideAlarm() 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


UnlockAlarm method 


Function 


Syntax 


Parameters 


UnselectAll 


Function 


812 


Executes the "Unlock alarm" key function of the AlarmControl. 


Ausdruck.UnlockAlarm() 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


Deselects all rows in the table-based control. 
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Syntax 


Parameters 


See also 


UnselectRow 


Function 


Syntax 


Parameters 


See also 


Write Method 
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Expression.UnselectAll () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


Row object (list) (Page 225) 


Deselects a particular row in the table-based control. 


Expression.UnselectRow (ByVal IRow As Long) 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


Long 


Parameters Description 


Number of the row to be selected. 


Row object (list) (Page 225) 


Description of Tag Object 


Writes a value synchronously or asynchronously in a tag. The "LastError" property can be used 
to determine whether the call was successful. 
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syntax 


Parameters 


814 


If the value of the tag is set successfully, the properties of the tag object are assigned the 
following values: 


Property Allocation 

Value Tag values set by the user (unchanged) 
Name Tag name (unchanged) 

QualityCode Bad Out of Service 

Timestamp 0 

LastError 0 

ErrorDescription mt 


If the value of the tag is not set successfully, the properties of the tag object are assigned the 
following values: 


Property Allocation 

Value Tag values set by the user (unchanged) 
Name Tag name (unchanged) 

QualityCode Bad Out of Service 

Timestamp 0 

LastError Write operation error codes 
ErrorDescription Error description on LastError 


Expression.Write [Value], [Writemode] 


Expression 
Necessary. An expression which returns a tag object. 


The value to be written can be transferred directly to the method as a parameter. If the 
parameter is not specified, the value in the "Value" property is used. The "Writemode" option 
parameter can be used to select whether the tag value should be written synchronously or 
asynchronously. If the "Writemode" parameter is not used, writing is performed asynchronously 
as its default value. 


During the writing process, no information is supplied on the status of the tags. 
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The "Value" property contains the value which was set before or during the writing operation, 
therefore is may not correspond to the real current value of the tag. If the data on the tag should 


be updated, use the Read method. 


Parameters 
Value (optional) 


Description 


The tag value is specified. The specified value 
overwrites the value in the "Value" property in the 
tag object. 

The tag value is not specified. The tag receives the 
current value from the "Value" property of the tag 
object. 


Writemode (optional) 


0 or empty: The tag value is written asynchronous- 
ly. 0 is the default value. 


1: The tag value is written synchronously. 


On asynchronous writing, itis written immediately into the tag image. The user does not receive 
any feedback if the value has been written in the programmable controller, too. 


In the case of synchronous writing (direct to the PLC), the writing operation actually occurs 
when the PLC is ready to operate. The use receives a check-back message if the writing 


operation was not successful. 


Example: 


Asynchronous writing 


'VBS104 

Dim objTag 

Set objTag = HMIRuntime.Tags ("Varl1") 
objTag.Value = 5 

objTag.Write 

MsgBox objTag.Value 


n 


or 


'VBS105 

Dim objTag 

Set objTag = HMIRuntime.Tags ("Varl") 
objTag.Write 5 

MsgBox objTag.Value 


n 
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Synchronous writing 


"VBS106 

Dim objTag 

Set objTag = HMIRuntime.Tags ("Varl") 
objTag.Value = 5 

objTag.Write ,1 

MsgBox objTag.Value 


or 


"VBS107 

Dim objTag 

Set objTag = HMIRuntime.Tags ("Varl") 
objTag.Write 5, 1 

MsgBox objTag.Value 


Description of TagSet Object 


The TagSet object offers the option of writing several tags in one call. 


Functionality here is mostly identical with that of a tag object. In the following, only deviations 


thereof are described. 


Expression 


Necessary. An expression which returns an object of type "TagSet". 


Parameters 


In order to write different values, the "Value" property of individual tag objects must be set, and 
write must be called thereafter without the "Value" parameter. Since the write commands are 
grouped into one call, it results in improved performance compared to single calls. 


In a TagSet object, it is not possible to pass on a value using the "Write" method. Individual 
values must be set using the "Value" property of the individual tag objects. 
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Example: 


The following example shows how tags are included in the TagSet list, how tag values are set 
and subsequently written. 


'VBS173 

Dim group 

Set group = HMIRuntime.Tags.CreateTagSet 
group.Add "Wert1" 
group.Add "Wert2" 
group ("Wert1") .Value = 
group ("Wert2") .Value 
group.Write 


| 
Wo W 


If you set the optional parameter "Writemode" equal to 1, the process tags are written 
synchronously (directly to AS). 


group.Write 1 


See also 

LastError Property (Page 459) 

ErrorDescription Property (Page 411) 

TagSet Object (List) (Page 141) 

Tag Object (Page 137) 
WriteTags method 
Function 

Executes the "Write tags" key function of the UserArchiveControl. 
Syntax 

Expression.WriteTags () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
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ZoomArea - Method 


Function 

Executes the "Zoom area" key function of the OnlineTrendControl and FunctionTrendControl. 
Syntax 

Ausdruck. ZoomArea () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


Zoom|nOut - Method 


Function 

Executes the "Zoom +/-" key function of the OnlineTrendControl and FunctionTrendControl. 
Syntax 

Ausdruck.ZoomInOut () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


Zoom InOutTime method 


Function 
Executes the "Zoom time axis +/-" key function of the OnlineTrendControl. 


Syntax 


Ausdruck. ZoomInOutTime () 
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Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


ZoomInOutValues - Method 


Function 


Syntax 


Parameters 


Executes the "Zoom value axis +/-" key function of the OnlineTrendControl. 


Ausdruck. ZoomInOutValues () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 


Zoom InOutX method 


Function 


Syntax 


Parameters 


Executes the "Zoom X axis +/-" key function of the FunctionTrendControl. 


Ausdruck. ZoomInOutxX () 


Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
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ZoomInOutY - Method 


Function 

Executes the "Zoom Y axis +/-" key function of the FunctionTrendControl. 
Syntax 

Ausdruck.ZoomInOutyY () 

Expression 

Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 


ZoomMove method 


Function 
Executes the "Move trend area" key function of the OnlineTrendControl and 
FunctionTrendControl. 
Syntax 
Ausdruck. ZoomMove () 
Expression 
Necessary. An expression that returns an object of the "Screenltem" type. 
Parameters 
1.14.6 Appendix 
1.14.6.1 Error Messages from Database Area 
Introduction 


Upon access to databases, a value is returned upon execution. Values in the range "0x8..." 
represent an error message. Values not equal to "0x8..." represent a status message. 
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Status Messages 
The following status messages are defined: 


0x0 OK 


0x1 Function did not find any errors in parameter supply and did not find any internal errors. The 
following causes may result in this value. 


When connecting databases: 
- No archive could be found in the given time window. 
- Archives were found in the given time window, but they were already connected. 


When separating databases: 
- No connected archives could be found in the given time window. No checks are performed 
on whether or not archives are attached at all. 


Error Messages 
The following error messages are defined (n in English only): 


Error code Error Message 

0x80047200 WinCC is not activated 

0x80047201 Invalid archive type 

0x80047202 Invalid lower boundary 

0x80047203 Invalid upper boundary 

0x80047204 Path 'CommonArchiving' could not be created in the project path 


0x80047205 Timeout, please retry 
0x80047206 WinCC was deactivated 


0x80047207 Wrong signification 
At least one database had a invalid signature and has not been attached. 


0x80047208 Database could not be attached 
0x80047209 Copy to 'CommonArchiving' is not possible. 


0x8004720A Invalid syntax for database filename. 
0x8004720B No list of databases. 

0x8004720C Database already detached. 
0x8004720D Database could not be detached. 


0x8004720F Unsigned database attached. 
At least one database without signature has been attached. 


0x80047210 Path error : 

- Path invalid, 

- no *.MDF files found in specified path or 
- no permission to specified path. 


See also 
Remove Method (Page 789) 
Write Method (Page 813) 
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Read Method (Page 783) 
Restore Method (Page 794) 
Logging Object (Page 122) 
DataLogs Object (Page 114) 
AlarmLogs Object (Page 112) 
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1.15 Examples of VBScript 
1.15.1 Examples of VBScript 
Introduction 


The following section contains application examples of VBS in WinCC. The "Examples in 
WinCC" section contains examples of codes with which the WinCC Runtime environment can 
be made dynamic. These examples have been conceived so that they can be assumed 1:1 in 
the configuration. 


The "General Examples" section contains examples with which to influence the Microsoft 
environment. There is no guarantee nor support for the running capability of these examples. 


See also 

Examples in WinCC (Page 823) 
1.15.2 Examples in WinCC 
1.15.2.1 Examples in WinCC 
Introduction 


This section contains examples of using VBScript in WinCC with regard to the following topics: 


Access to objects in the Graphics Designer (e.g. color or text change) 
Set color of objects above RGB colors 

Configuring language change 

Deactivate Runtime 

Start external program 

Globally configure picture change (from Global Script) 
Configuring Change Picture Via Property 

Use trace for diagnostics output 

Set value of a tag 

Read value of a tag 

Check the success of a read/write action into a tag 


Asynchronously set value of a tag 
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See also 


Example: 
Example: 
Example: 
Example: 
Example: 
Example: 
Example: 
Example: 
Example: 
Example: 


Example: 


Starting an external application (Page 859) 

Writing Object Properties (Page 833) 

How to Read Tag Values (Page 830) 

Writing tag values (Page 828) 

Configuring diagnostics output via Trace (Page 827) 
Configuring Change Picture Via Property (Page 827) 
Configuring change picture globally (Page 826) 
Deactivating Runtime (Page 826) 

How to Configure Language Changes (Page 825) 
Defining the color of objects (Page 825) 

Accessing objects in Graphics Designer (Page 824) 


1.15.2.2 Example: Accessing objects in Graphics Designer 


Introduction 


Access can be made to all Graphic Designer objects using VBS WinCC in order to make the 
graphic Runtime environment dynamic. Graphic objects can be made dynamic on operation 
(e.g. clicking the mouse on a button), depending on a tag or cyclically (e.g. flashing). 


The following examples illustrate how to change a graphic object following a mouse click. 


Procedure 


In the following example, the radius of a circle is set to 20 in Runtime per mouse click: 


'VBS121 
Dim objCircle 


Set objCircle= ScreenItems ("Circlel") 


objCircle.Radius = 20 


Note 


The expression used in the example only applies to Graphics Designer. In the case of analog 
actions in Global Script, address the objects using the HMIRuntime object. 


See also 


Examples in WinCC (Page 823) 
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The colors of graphic objects are defined via RGB values (Red/Green/Blue). The color values 


Introduction 
for graphic objects can be set or read out. 
Procedure 
The following example defines the fill color for "ScreenWindow1" to blue: 
"VBS122 


Dim objScreen 
Set objScreen = HMTRuntime.Screens ("ScreenWindowl") 


objScreen.FillStyle = 131075 
objScreen.FillColor = RGB(0O, 0, 255) 


See also 
Examples in WinCC (Page 823) 


1.15.2.4 Example: How to Configure Language Changes 


Introduction 
The Runtime language of WinCC can be changed 


using VBS. The most typical use is buttons 


with the corresponding language codes which are placed on the start page of a project. 


You specify the Runtime language in VBS by using a country code, e.g., 1031 for German - 
Default, 1033 for English - USA etc. Asummary of all country codes may be found in the Basics 
of VBScript under the subject header "Regional Scheme ID (LCID) Diagram". 


Procedure 
Use the "Mouse click" event on a button to create 
code to switch the Runtime language to German: 


'VBS123 
HMTRuntime.Language = 1031 


See also 
Examples in WinCC (Page 823) 
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1.15.2.5 Example: Deactivating Runtime 


Introduction 
It is possible to terminate WinCC Runtime with VBS, e.g. via a mouse click or in dependence 
on tag values or other events, such as multiple faulty input of a password when starting 
Runtime. 
What to do 
The following example terminates WinCC Runtime: 
'VBS124 


HMIRuntime.Stop 


See also 
Examples in WinCC (Page 823) 


1.15.2.6 Example: Configuring change picture globally 


Introduction 
VBS can be used to initiate a global picture change and thus, for example, display a picture 
from a server on aclientin a distributed system. To do this, server's server prefix must precede 
the target picture. 
What to do 
Configure the following code for a picture change to a button, for example: 
'VBS125 
HMIRuntime.BaseScreenName = "Serverprefix::New screen" 
See also 


Examples in WinCC (Page 823) 
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1.15.2.7 Example: Configuring Change Picture Via Property 


Introduction 
If partitioned pictures are used in the configuration, e.g. in a basic picture title and operating 
bar for the user interface and an embedded picture window for the actual picture display, 
configure a picture change using the properties of the picture window. 


The property of the "ScreenName" picture window must be changed in order for the other 
picture to appear. The action and picture window must be configured in the same picture. 


What to do 
In the following example, the "test.pdl" picture is displayed in the "ScreenWindow" picture 


window when executing the action: 


'VBS126 
Dim objScrWindow 
Set objScrWindow = ScreenItems ("ScreenWindow") 


objScrWindow.ScreenName = "test" 


See also 
Examples in WinCC (Page 823) 


1.15.2.8 Example: Configuring diagnostics output via Trace 


Introduction 
If a GSC diagnostics window has been inserted in the picture, diagnostics output can be 
displayed in the diagnostics window in Runtime using the Trace command. 


GSC Diagnostics issues the Trace methods contained in the actions in the chronological 
sequence they are called. This also applies to Trace instructions in procedures which are called 
in actions. The targeted implementation of Trace instructions, e.g. for the output of tag values, 
enables the progress of actions and the procedures called in them to be traced. The Trace 
instructions are entered in the form "HMlRuntime. Trace(<Ausgabe>)". 


The GSC Diagnostics displays trace output from C and VBS. 


What to do 
The following example writes a text in the diagnostics window: 


'VBS127 


HMIRuntime.Trace "Customized error message" 
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See also 


Examples in WinCC (Page 823) 


1.15.2.9 Example: Writing tag values 


Introduction 


Using VBS, it is possible to write a tag value to the PLC, e.g. by clicking the mouse on a button 
to specify setpoint values, or to set internal tag values to trigger other actions. 


Various write variations are mentioned and explained below. 


Simple writing 


In the following example, a value is written to the "Tag1" tag: 


'VBS128 
HMTRuntime.Tags("Tagl") .Write 6 


This is the simplest form of writing since no object reference is generated. 


Writing with object reference 


In the following example, a local copy of the tag object is created and a value written to "Tag1": 


"'VBS129 

Dim objTag 

Set objTag = HMIRuntime.Tags ("Tagl") 
objTag.Write 7 


Referencing offers the advantage of being able to work with the tag object before writing. The 
tag value can be read, calculations executed and written again: 


'VBS130 


Dim 
Set 


objT 
obj1 
objT 
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objTag 
objTag = HMIRuntime.Tags ("Tagl") 
ag.Read 


[Tag.Value = objTag.Value + 1 


ag.Write 
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Synchronous writing 


'VBS131 

Dim objTag 
Set objTag = 
objTag.Write 8.1 


"'VBS132 


Dim 
Set 


objT 
objT 


objTag 


Normally, the value to be written is transferred to the tag management and processing of the 
action resumed. In some cases, however, it must be ensured that the value has actually been 
written before processing of the action can be resumed. 


This type of writing is realized by specifying the value 1 for the additional, optional parameters: 


HMIRuntime.Tags ("Tagl") 


or 


objTag = HMIRuntime.Tags ("Tagl") 


ag.Value 


8 


ag.Write ,1l 


Note 


Please note that the call takes longer in comparison to the standard call. The duration is also 
dependent on the channel and AS, amongst other things. 


The type of writing complies to the SetTagXXXWait() call in C scripting. 


Writing with status handling 
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In order to ensure that a value has been written successfully, it is necessary to execute an 
error check or determine the status of the tag, after the writing process. 


This is done by checking the value of the "LastError" property after writing. When the test 
proves successful, i.e. the job has been placed successfully, the tag status is checked. 


In the case of a write job, the current status from the process is not determined. To establish 
this, it is necessary to read the tag. The value specified in the Quality Code property after the 
read process provides an indication of the tag status and, if necessary, makes reference to a 


failed AS connection. 
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In the following example, the "Tag1" tag is written. If an error occurs during writing, the error 
value and error description appear in the Global Script diagnostics window. Finally, the Quality 
Code is checked. If the Quality Code is no OK (0x80), it is displayed in the diagnostics window. 


'VBS133 

Dim objTag 

Set objTag = HMIRuntime.Tags ("Tagl") 

objTag.Write 9 

If 0 <> objTag.LastError Then 

HMIRuntime.Trace "Error: " & objTag.LastError & vbCrLf & "ErrorDescription: " & 
objTag.ErrorDescription & vbCrLf 

Else 
objTag.Read 
If &H80 <> objTag.QualityCode Then 

HMTRuntime.Trace "QualityCode: Ox" & Hex (objTag.QualityCode) & vbCrLf 


End If 
End If 
Note 
After writing a tag, the QualityCode property of the local tag object is set to "BAD Out of Service" 
because it is not known which Quality Code manages the tag in the process. 
The Quality Code cannot be written from VBS. 
See also 


Write Method (Page 813) 
Examples in WinCC (Page 823) 


1.15.2.10 Example: How to Read Tag Values 


Introduction 


VBS can be used to read and further process a tag value. This makes it possible, for example, 
to click the mouse on a button to obtain information on the system status or to execute a 
calculation. 


Various read variations are mentioned and explained below. 
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Simple reading 


"'VBS134 


HMTRuntim 


In the following example, the value of "Tag1" is read and displayed in the Global Script 
diagnostics window: 


-Trace "Value: " & HMIRuntime.Tags("Tagl").Read & vbCrLf 


This is the simplest form of reading since no object reference is generated. 


Reading with object reference 


In the following example, a local copy of the tag object is created, the tag value read and 
displayed in the Global Script diagnostics window: 


"VBS135 

Dim objTag 

Set objTag = HMIRuntime.Tags ("Tagl") 

HMITRuntime.Trace "Value: " & objTag.Read & vbCrLf 
Referencing offers the advantage of being able to work with the tag object. The tag value can 
be read, calculations executed and written again: 

'VBS136 

Dim objTag 

Set objTag = HMIRuntime.Tags ("Tagl") 

objTag.Read 

objTag.Value = objTag.Value + 1 

objTag.Write 


Using the Read method, process tags which have been read are added to the image, from 
this moment on they cyclically requested from the AS. If the tag is already in the image, the 
value contained in it is returned. 


For Close Picture, the tag actions are ended again. 


Note 


If a tag is requested in a Global Script action, it remains registered throughout the enter Runtime 
of WinCC. 


Direct reading 


Normally, the tag values are read from the tag image. In certain situations, however, it may be 
necessary to read the value direct from the AS, e.g. to synchronize fast processes. 
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'VBS137 
Dim objTag 


If the optional parameter is set to 1 for the read process, the tag is not logged in cyclically but 
the value is requested once from the AS. 


Set objTag = HMIRuntime.Tags ("Tagl") 


HMTRuntime.Trac 


"Value: " & objTag.Read(1) & vbCrLf 


Note 


Please note that the call takes longer in comparison to the standard call. The duration is also 
dependent on the channel and AS, amongst other things. 


This type of call must be avoided in the case of cyclic C actions because this is the main reason 
for performance problems. 


This type of read process corresponds to GetTagXxXXWait() call from C scripting. 


Reading with status handling 


'VBS138 
Dim objTag 


In order to ensure that a value is valid, a check should be made following reading. This occurs 
by the fact that the Quality Code is controlled. 


In the following example, the "myWord" tag is read and the QualityCode then checked. When 
the Quality Code does not correspond to OK (0x80) the LastError, ErrorDescription and 
QualityCode properties are displayed in the Global Script diagnostics window. 


Set objTag = HMIRuntime.Tags ("Tagl") 


objTag.Read 


If &H80 <> objTag.QualityCode Then 


HMIRuntime.1 


Else 


HMIRuntime.T 


[Trace "Error: " & objTag.LastError & vbCrLf & "“ErrorDescription: " & 
objTag.ErrorDescription & vbCrLf & "QualityCode: Ox" & Hex(objTag.QualityCode) & vbCrLf 


race "Value: " & objTag.Value & vbCrLf 


End If 
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Note 


If an error occurs during reading, QualityCode is set to BAD NON-SPECIFIC. Therefore, it is 
sufficient to check the QualityCode following reading. 
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See also 
Read Method (Page 783) 
Examples in WinCC (Page 823) 


1.15.2.11 Example: Writing Object Properties 


Introduction 
VBS enables access to the properties of all Graphics Designer picture objects. Properties can 
be read out to be modified or changed during Runtime. 
The following examples illustrate various forms of access. 

Simple setting of a property 
In the following example, the background color of the "Rectangle1" object contained in the 
picture is set to red: 

'VBS139 


ScreenItems ("Rectanglel") .BackColor = RGB(255,0,0) 
This is the simplest form of writing since no object reference is generated. 


Note 


If the work is completed without an object reference, only the standard properties are provided 
in Intellisense. 


The form of expression used in the example only applies to Graphics Designer. In the case of 
analog actions in Global Script, address the objects using the HMIRuntime object. 


Setting a property with object reference 


In the following example, a reference is created to the "Rectangle1" object contained in the 
picture and the background is set to red using the VBS standard function RGB(): 


'VBS140 

Dim objRectangle 

Set objRectangle = ScreenItems ("Rectanglel") 
objRectangle.BackColor = RGB(255,0,0) 
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Referencing is useful when several object properties must be changed. When using 
Intellisense, this process then lists all the object properties. 


Note 


The form of expression used in the example only applies to Graphics Designer. In the case of 
analog actions in Global Script, address the objects using the HMIRuntime object. 


Setting properties via the picture window 
VBS in Graphics Designer offers two possibilities for picture transcending addressing: 


e via the Screen object of a picture window with "Screenltems" 


e from the basic picture with "HMIRuntime.Screens" 


Referencing via the picture window 

In the following example, the color of a rectangle is changed in an subordinate picture window. 
The script is executed in the picture "BaseScreen", in which the picture window 
"ScreenWindow1" is located. The picture window displays a picture, which contains an object 
of the type "Rectangle" with the name "Rectangle1". 


"VBS199 
Sub OnLButtonUp (ByVal Item, ByVal Flags, ByVal x, ByVal y) 


Dim objRectangle 

Set objRectangle = ScreenItems ("ScreenWindowl") .Screen.ScreenItems ("Rectanglel") 
objRectangle.BackColor = RGB(255,0,0) 

End Sub 


Referencing from the basic picture 

You can reference the picture with the object to be modified via HMlRuntime.Screens. The 
specification of the picture is defined relative to the basic picture via the following access code: 
[<Grundbildname>.]<Bildfenstername>[:<Bildname>]... .<Bildfenstername>[:<Bildname>] 


In the following example, a reference is created to the "Screen2" object contained in the 
"Rectangle1" picture and the background color is set to red. 


The picture "Screen2", in this case, is in "Screen1". "Screen1" is displayed in the basic picture 
"BaseScreen". 


"VBS141 
Dim objRectangle 


Set objRectangle = 
HMIRuntime.Screens ("BaseScreen.ScreenWindowl :Screenl.ScreenWindowl :Screen2") .ScreenItems (" 


Rectanglel") 
objRectangle.BackColor = RGB(255,0,0) 
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It is not necessary to specify the picture name. It is possible to address a picture uniquely using 
the picture window name. Therefore, it is sufficient to specify the name of the picture window, 


as in the following example: 


"VBS142 

Dim objRectangle 

Set objRectangl 

HMTRuntime.Screens ("ScreenWindowl.ScreenWindow2") .ScreenItems ("Rectanglel") 


objRectangle.BackColor = RGB(255,0,0) 


This type of addressing enables objects in picture windows to be addressed in different 
pictures. This is a particularly interesting aspect in respect of the picture module technique. 


Make the property dynamic using the return value 
Actions on properties can not only be triggered by events or cyclically but properties can also 
be made dynamic directly via an action. 
In the following example, the background color of an object is made dynamic via a return value. 
The value transferred can come from the evaluation of events in the PLC, for example and 
used for the graphic display of an operating status: 


"VBS146 

Function BackColor Trigger (ByVal Item) 
BackColor Trigger = RGB(125,0,0) 

End Function 


Note 


If you make an object property dynamic with a VBS action via the return value of a script, the 
value of the object property is written only if it has changed in relation to the last script run. It 
is not considered if the value had been changed from another location. 


Therefore it is illegal to change properties which have been made dynamic by VBS action via 
the return value from another location (e.g., other C scripts or VBS scripts). 


if you do not observe this, wrong values can be the results. 


See also 
VBS Reference (Page 105) 
Examples in WinCC (Page 823) 
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1.15.2.12 


Introduction 


What to do 
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Example: How to Start an Action on the Server (Logging Object) 


In multi-user projects, the Logging object presently functions on the server only. The following 
example shows how to start an action on the server from the client, and how to swap and 
delete archive segments on client accordingly. 


The example shows a global action started with a control tag. The contents of the control tag 
determine whether the "Restore" method or the "Remove" method is called. At the end of the 
action, the control tag is set to "0". 


A query prevents the action from being started on client computers. 
Path and time period are passed on by internal tags. 


The path information may also contain a network release. Archive segments to be swapped 
must therefore not be stored locally at the server. It must be warranted, though, that the server 
may directly access the path. 


Note 


The example shows a delete suggestion and may be adjusted as needed. 


1. Create the following internal tags with project-wide updating in the WinCC Explorer: 
- StartLogging (unsigned 8 bit value) 
- SourcePath (Text tag 8 bit character set) 
- TimeFrom (Text tag 8 bit character set) 
- TimeTo (Text tag 8 bit character set) 
- RetVal (signed 32 bit value) 


2. Create a global VBS action and enter the tag ’StartLogging’ as tag trigger with cycle "Upon 
Change". 


3. Copy the following script into the action 
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"VBS180 
Dim StartLogging 
Dim SourcePath 


fs 


Dim TimeFrom 


Dim TimeTo 

Dim RetVal 

"Exit when running on client 

If (Left (HMIRuntime.ActiveProject.Path, 1) = "\") Then 
Exit Function 

End If 

"read parameters 

StartLogging = HMIRuntime.Tags ("StartLogging") .Read 
SourcePath = HMIRuntime.Tags ("SourcePath") .Read(1) 
TimeFrom = HMIRuntime.Tags ("TimeFrom") .Read(1) 

TimeTo = HMIRuntime.Tags ("TimeTo") .Read (1) 

"restore or remove depends on the parameter 

If (StartLogging = 1) Then 

RetVal = HMIRuntime.Logging.Restore(SourcePath, TimeFrom, TimeTo, -1) 
HMTRuntime.Tags("RetVal") .Write RetVal, 1 
HMTRuntime.Tags("StartLogging") .Write 0,1 

Elseif (StartLogging = 2) Then 


RetVal = HMIRuntime.Logging.Remove (TimeFrom, TimeTo, -1) 
HMTRuntime.Tags("RetVal") .Write RetVal, 1 
HMTRuntime.Tags("StartLogging") .Write 0,1 

End If 


The action may be started on a client with the following action, for example. Please note that 
parameters must be written prior to setting the control tag. 


'VBS181 

"set parameters 

HMIRuntime.Tags ("SourcePath") .Write "\\client_pc\temp",1 
HMTIRuntime.Tags("TimeFrom") .Write "2004",1 
HMIRuntime.Tags("TimeTo") .Write "2004",1 

"start action 

HMTIRuntime.Tags("StartLogging") .Write 1.1 


Note 


Tags are predominantly written and read in "direct" mode. This will synchronize the sequences. 
Since this deals with internal tags, this mode may be used without any further concerns. 
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1.15.2.13 


Introduction 


Requirement 
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Example: You connect or disconnect a database backup with VBS 


You can connect and read swapped-out databases with VBScript. 


The example below describes access to a swapped-out WinCC process value archive via the 
WinCC OLE DB Provider. A backup file is connected, read and the connection terminated 


again. 

1. Create connection for access via ADO and specify data source (1.1) 

2. Define command for access: Read relative time range for the last 10 minutes (1.2) 
3. Establish the connection (2.1) 

4. Execute command (2.2) 

5. Define data record structure and test first data record (2.3) 

6. Call subsequent rows of the result set (3.1) 

7. Clean up: Disconnect (4.1) 


The example does not include error processing. 


Further information on the OLE DB Provider is available in the documentation for the WinCC/ 
Connectivity Pack under "Access via OLE DB Provider > Retrieve archive data". 


e WinCC or WinCC/Connectivity Pack is installed on the PC. 
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Example 


"VBS372 
Sub OnClick(Byval Item) 


Const MaxRows = 100 


" 1.1 Create connection string for ADO access 
Dim ProviderName 

Dim CatalogName 

Dim DataSourceName 

Dim ConnectionString 

Dim CommandString 


ProviderName = "Provider=WinCCOLEDBProvider.1;" 
CatalogName = "Catalog=CC Test 15 04 14 08 23 27R;" 
DataSourceName = "Data Source=.\WinCC" 


ConnectionString = ProviderName + CatalogName + DataSourceName 


' 1.2 Define command string for access (relative time range, last 10 
minutes) 

CommandString = "TAG:R, 'ArcTag\Tag_1','0000-00-00 
00:10:00.000','0000-00-00 00:00:00.000'" 


Dim DBConnection 
Dim DBCommand 
Dim DBRecordset 


' 2.1 Open connection 

HMIRuntime.Trace "before open connection" & vbNewLine 
Set DBConnection = CreateObject ("ADODB.Connection") 
DBConnection.ConnectionString = ConnectionString 
DBConnection.CursorLocation = 3 
DBConnection. open 


Set DBRecordset = CreateObject ("ADODB.Recordset") 


' 2.2 Execute command 

HMIRuntime.Trace "befor xecute command" & vbNewLine 
Set DBCommand = CreateObject ("ADODB.Command") 
DBCommand.CommandType = 1 

DBCommand.ActiveConnection = DBConnection 
DBCommand.CommandText = CommandString 

Set DBRecordset = DBCommand.Execute 


Dim lngCount 
Dim lngValue 


' 2.3 Record structure and first record data (test) 

ingCount = DBRecordset.Fields.Count 

HMTRuntime.Trace "RecordSet.Field.Count=" & IngCount & vbNewLine 
Tf (lngCount>0) Then 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 839 


VBS for Creating Procedures and Actions 
7.15 Examples of VBScript 


DBRecordset.movefirst 


ingValue = DBRecordset.Fields (0) .Value 

HMIRuntime.Trace "RecordSet.Fields(0).Value=" & IngValue & " (ValueID)" 
& vbNewLine 

IngValue = DBRecordset. Fields (1).Value 

HMTRuntime.Trace "RecordSet.Fields(1).Value=" & IngValue & 
" (TimeStamp)" & vbNewLine 

ingValue = DBRecordset.Fields (2) .Value 


HMTRuntime.Trace "RecordSet.Fields(2).Value="& IngValue & " (Value)" 
& vbNewLine 
ingValue = DBRecordset.Fields (3) .Value 
HMTRuntime.Trace "RecordSet.Fields(3).Value="& IngValue & 
"" (QualityCode)" & vbNewLine 

ingValue = DBRecordset.Fields (4) .Value 
HMTRuntime.Trace "RecordSet.Fields(4).Value="& IngValue & " (Flags)" 
& vbNewLine 


Dim DBValueID 

Dim DBTimeStamp 
Dim DBValue 

Dim DBQualityCode 
Dim DBFlags 


Dim Count 


Count = 0 
HMIRuntime.Trace "before While DBReader (MaxRows=" & MaxRows & ")" & 
vbNewLine 


' 3.1 Fetch subsequent rows of the result set 
DBRecordset.movefirst 

Do While (Not DBRecordset.EOF And Count < MaxRows) 
DBValueID = DBRecordset.Fields(0) .Value 
DBTimeStamp = DBRecordset.Fields(1).Value 
DBValue = DBRecordset.Fields(2) .Value 
DBQualityCode = DBRecordset.Fields(3).Value 
DBFlags = DBRecordset.Fields (4) .Value 


HMIRuntime.Trace "Rec[" & Count & "]J=( " & DBValueID & "," & 
DBTimeStamp & "," & DBValue & "," & DBQualityCode & "," & DBFlags & " )" & 
vbNewLine 


Count = Count + 1 
DBRecordset .movenext 
Loop 
HMIRuntime.Trace Count & "records read finish" & vbNewLine 


Else 


HMTRuntime.Trace "Selection returned no fields" & vbNewLine 
End If 


'" 4.1 Clean up 
DBRecordset.Clos 

Set DBRecordset = Nothing 
Set DBCommand = Nothing 
DBConnection.Close 

Set DBConnection = Nothing 
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HMTRuntime.Trace "Connection closed again" & vbNewLine 


End Sub 


1.15.2.14 Dynamization of Controls 


Example: Calling Methods of an ActiveX Control 


Introduction 


The following examples illustrate how to call methods and properties of an ActiveX control 
which is embedded in a WinCC picture. 


Example 1: WinCC FunctionTrendControl 


This example fills "Trend 1" of the FuntionTrendControl "Control1" with values which describe 
a parabola. 


To dynamize a trend with VBS, in the configuration dialog of the control on the "Data 
connection" tab under "Data supply" set "O - None". 


"VBS300 

Dim lngFactor 

Dim dblAxisX 

Dim dblAxisY 

Dim objTrendControl 
Dim objTrend 


Set objTrendControl = ScreenItems("Controll") 
Set objTrend = objTrendControl.GetTrend("Trend 1") 


For lngFactor = -100 To 100 

dblAxisX = CDbl(lngFactor * 0.02) 

dblAxisY = CDbl1(dblAxisX * dblAxisX + 2 * dblAxisX + 1) 
objTrend.InsertData dblAxisX, dblAxisY 

Next 


Example 2: WinCC FunctionTrendControl with value supply via array 


Inthis example, "Trend 1" of the FunctionTrendControl "Control1" is supplied with values stored 
in arrays. 
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To dynamize a trend with VBS, in the configuration dialog of the control on the "Data 
connection" tab under "Data supply" set "O - None". 


'VBS301 

Dim lIngIndex 

Dim dblAxisxX (100) 
Dim dblAxisyY (100) 


Dim objTrendControl 

Dim objTrend 

Set objTrendControl = ScreenItems("Controll") 

Set objTrend = objTrendControl.GetTrend("Trend 1") 


For IngIndex = 0 To 100 


db1lAxisX (lngIndex) = CDb1l(lngIndex * 0.8) 
dblAxisY (lngIndex) = CDb1 (lngIndex) 
Next 


objTrend.InsertData dblAxisX, dblAxisY 


Example 3: WinCC FunctionTrendControl (before WinCC V7) 


This example fills the FunctionTrendControl named "Control1" with values that describe a 
parabola. 


"'VBS111 

Dim lIngFactor 

Dim dblAxisX 

Dim dblAxisyY 

Dim objTrendControl 

Set objTrendControl = ScreenItems("Controll") 
For lngFactor = -100 To 100 

dblAxisX = CDbl(lngFactor * 0.02) 

dblAxisY = CDb1(dblAxisX * dblAxisX + 2 * dblAxisX + 1) 
objTrendControl.DataX = dblAxisxX 
objTrendControl.DataY = dblAxisY 
objTrendControl.InsertData = True 

Next 
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Example 4: WinCC FunctionTrendControl with value supply via array (before WinCC V7) 


In this example, a FunctionTrendControl called "Control1" is supplied with 100 value pairs. In 
order that the value pair can be transferred correctly, the transfer e.g. in "dblAxisXY" must not 
occur directly but via an intermediate tag, e.g. "varTemp". 


'VBS152 

Dim lngIndex 

Dim db1XyY(1) 

Dim dblAxisxXyY (100) 

Dim varTemp 

Dim objTrendControl 

Set objTrendControl = ScreenItems("Controll") 
For IngIndex = 0 To 100 

db1lxy (0) = CDbl(lngIndex * 0.8) 

db1lxy(1) = CDb1 (lngIndex) 

dblAxisXY (lngIndex) = dblXY 
Next 
varTemp = (dblAxisxXY) 
objTrendControl.DataxY = varTemp 
objTrendControl.InsertData = True 


Example 5: Microsoft Web Browser 


This example controls MS Web Browser. 


'VBS112 

Dim objWebBrowser 

Set objWebBrowser = ScreenItems ("WebControl") 
objWebBrowser.Navigate "http://www.siemens.de" 


obj WebBrowser. GoBack 
obj WebBrowser.GoForward 


objWebBrowser.Refresh 


obj WebBrowser.GoHome 


obj WebBrowser.GoSearch 


objWebBrowser.Stop 


Note 


Insert the instructions, separated by stops, in self-defined procedures. Declaration and 
assignments must always precede them. 
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See also 


General examples for VBScript (Page 855) 


Example: How to configure a user-defined toolbar button with a self-created selection dialog 


Introduction 


In the following example you create a user-defined toolbar button of an OnlineTrendControl. 
On this toolbar button you configure a self-created selection dialog with which you can 
optionally set one of two different time ranges of the OnlineTrendControl. 


Requirement 


The Graphics Designer is open. 


An archive is created in the Tag Logging Editor. 


Inserting and configuring WinCC OnlineTrendControl 


1. 


oa 


Create a new process picture in the Graphics Designer. 


2. Save the process picture under "OnlineTrend.pdl". 
3. 
4 


. Select "Configuration dialog..." from the shortcut menu of the control. 


Insert a WinCC OnlineTrendControl into the process picture. 


The "Properties of WinCC OnlineTrendControl" dialog opens. 


. On the "Trend" tab under "Data connection" connect the trend to an archive tag. 


6. Onthe "Toolbar" tab under "Button functions" create a new user-defined toolbar button with 


object ID "1001" for the OnlineTrendControl. 


. Click on "Accept" to save the changes. 


. Click "OK" to close the dialog box. 


9. Select "Properties" from the shortcut menu of the control. 


The "Object properties" dialog box opens. 


10.Enter "Control1" as the object name for the control. 


11.In the Object Properties of "Control1" select the "Event" tab. 


12.0n the "OnToolbarButtonClicked" object event, configure the VB script "Create VBS action 


on "OnToolbarButtonClicked" event of user-defined toolbar button (VBS302)". 


13.Close the "Object properties" dialog box. 


Creating a process picture for the selection dialog 


1. 
2. 
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Create a new process picture in the Graphics Designer. 


Save the process picture under "Selectiondialog.pd|". 
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3. Click the "Properties" button on the shortcut menu of the process picture. 
The "Object properties" dialog box opens. 


. Under "Geometry", set value "200" for the "Picture width" and "Picture height" attributes. 
. Close the "Object properties" dialog box. 


. Insert two "Button" objects into the process picture. 


N DO On Ff 


. Enter "Morning" or "Afternoon" as text for the button. 


Dynamizing selection dialog button 
1. In the Object Properties of the "Morning" button select the "Event" tab. 


2. On the "Mouse-click" event, configure the VB script "Create VBS action on "Mouse-click" 
event of "Morning" button (VBS303)". 


3. Close the "Object properties" dialog box. 
4. Inthe Object Properties of the "Afternoon" button select the "Event" tab. 


5. On the "Mouse-click" event configure the VB script "Create VBS action on "Mouse-click" 
event of "Afternoon" button (VBS304)". 


6. Close the "Object properties" dialog box. 


Inserting and configuring a picture window 
1. Insert a "Picture window" object into the "OnlineTrend.pdl" process picture. 


2. Select "Properties" from the shortcut menu of the picture window. 
The "Object properties" dialog box opens. 


3. Enter "PictureWindow1" as the object name for the picture window. 
4. Under "Miscellaneous" set the "Display" attribute to "no". 


5. Under "Miscellaneous", select the "Selectiondialog.pdl" process picture for the "Picture 
name" attribute. 


6. Close the "Object properties" dialog box. 


Create VBS action on "OnToolbarButtonClicked" event of user-defined toolbar button (VBS302) 


"'VBS302 

"Open selection window if Toolbarbutton with ID 1001 is pressed 
Tf lId = 1001 Then 

ScreenItems ("PictureWindowl") .Visible = True 

End If 
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Create VBS action on "Mouse-click" event of "Morning" button (VBS303) 


'VBS303 
Dim obj 


Set obj = Parent.Parent.Scr 


"choose time axis, 
obj .TimeAxisName = 
obj .TimeAxisActualize 


stop update, 
"Time axis 1" 


nitems ("Controll") 
set begin time and time range 


= False 
= CStr(Date & " 4:00:00") 


obj .TimeAxisBeginTim 
obj. 
obj. 


TimeAxisTimeRangeBase = 
TimeAxisTimeRangeFactor = 8 


3600000 


"close the selection window 


Parent.Visible = 


False 


Create VBS action on "Mouse-click" event of "Afternoon" button (VBS304) 


"VBS304 
Dim obj 


Set obj = Parent.Parent.Scr 


"choose time axis, 
obj .TimeAxisName = 
obj .TimeAxisActualize 


stop update, 
"Time axis 1" 


nitems ("Controll") 
set begin time and time range 


= False 
= CStr(Date & " 12:00:00") 


obj .TimeAxisBeginTim 
obj. 


TimeAxisTimeRangeBase = 


3600000 


obj .TimeAxisTimeRangeFactor = 8 


"close the selection window 
Parent.Visible = False 


Example: How to add elements to an empty WinCC OnlineTrendControl 


Introduction 


Requirement 


In the following example you insert the Trend Window, Value Axis, Time Axis and Trends 
elements into an empty WinCC OnlineTrendControl. 


e The Graphics Designer is open. 


e An archive is created in the Tag Logging Editor with three archive tags. 
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Inserting and configuring WinCC OnlineTrendControl 


1. 


N DO oO Ff 


Create a new process picture in the Graphics Designer. 


. Insert a WinCC OnlineTrendControl into the process picture. 


. Select "Configuration dialog..." from the shortcut menu of the control. 


The "Properties of WinCC OnlineTrendControl" dialog opens. 


. Inthe "Trends" area of the "Trends" tab delete the default trend window "Trend 1". 
. Click on "Accept" to save the changes. 
. Click "OK" to close the dialog box. 


. Select "Properties" from the shortcut menu of the control. 


The "Object properties" dialog box opens. 


. Enter "Control1" as the object name for the control. 


. Close the "Object properties" dialog box. 


Inserting and configuring a button 


1. 
2. 
3. 


Insert a "Button" object into the process picture. 
Enter "Paste elements" as text for the button. 


Select "Properties" from the shortcut menu of the button. 
The "Object properties" dialog box opens. 


. Inthe Object Properties of the button select the "Event" tab. 


. On the "Mouse-click" event configure the VB script "Create VBS action on "Mouse-click" 


event of button (VBS305)". 


. Close the "Object properties" dialog box. 
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Create VBS action on "Mouse-click" event of button (VBS305) 


'VBS305 

Dim objTrendControl 

Dim objTrendWindow 

Dim objTimeAxis 

Dim objValueAxis 

Dim objTrend 

"create reference to TrendControl 

Set objTrendControl = ScreenItems ("Controll") 

"create reference to new window, time and value axis 

Set objTrendWindow = 

obj TrendControl.GetTrendWindowCollection. AddItem ("myWindow") 
Set objTimeAxis = 

obj TrendControl.GetTimeAxisCollection.AddItem ("myTimeAxis") 
Set objValueAxis = 

obj TrendControl.GetValueAxisCollection.AddItem("myValueAxis") 


‘assign time and value axis to the window 


obj 


obj 


a 


TimeA 


xis.TrendWindow = objTrendWindow. Name 


ValueAxis.TrendWindow = objTrendWindow.Name 


‘add new trend and assign properties 
Set objTrend = objTrendControl.GetTrendCollection.AddItem ("myTrend1") 


obj 
obj 
obj 
obj 
obj 
obj 


47 


i 


es 


7 


= 


a 


Trend 


Trend. 
Trend. 
Trend. 


.Provider = 1 

TagName = "TestArchive\ArchivTagl" 
Color = RGB(255,0,0) 

TrendWindow = objTrendWindow.Name 


Fs 


Trend. 
Trend. 


"add new 
Set objTrend = objTrendControl.GetTrendCollection.AddItem ("myTrend2") 


obj 
obj 
obj 
obj 
obj 
obj 


= 


eq 


a 


Es 


eS 


Trend 


Trend. 
Trend. 
Trend. 
Trend. 


[TimeAxis = objTimeAxis.Name 
ValueAxis = objValueAxis.Name 


trend and assign properties 


.Provider = 1 

TagName = "TestArchive\ArchivTag2" 
Color = RGB(0,255,0) 

TrendWindow = objTrendWindow.Name 


"add new 
Set objTrend = objTrendControl.GetTrendCollection.AddItem ("myTrend3") 


obj 
obj 
obj 
obj 
obj 
obj 
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= 


és 


a 


ea 


47 


ea 


Trend 


Trend. 


Trend. 
Trend. 
Trend. 
Trend. 


TimeAxis = objTimeAxis.Name 
ValueAxis = objValueAxis.Name 


trend and assign properties 


.Provider = 1 

TagName = "TestArchive\ArchivTag3" 
Color = RGB(0,0,255) 

TrendWindow = objTrendWindow.Name 


Trend. 


TimeAxis = objTimeAxis.Name 
ValueAxis = objValueAxis.Name 
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Note 


In the VB script, replace the archive used and the archive tags "Archive\ArchiveTagxX" with the 
names of the archive and archive tags that have been created. 


Example: How to add a trend and a setpoint trend to an empty OnlineTrendControl. 


Introduction 


In the following example, you add a trend and a setpoint trend to an empty WinCC 
OnlineTrendControl. The time axis and value axis are added for the trends in a trend window. 


Requirement 


e A"WinCC OnlineTrendControl" with the name "Control2" is inserted in the process picture 
in the Graphics Designer. 


e A button is inserted in the Graphics Designer. You have configured the event "mouse click", 
for example, for the button, with a VBS action and the following script. 
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Example 


"VBS352 

Dim objTrendControl 
Dim objTrendWindow 
Dim objTimeAxis 

Dim objValueAxis 
Dim objTrend 

"tags used to generate trend data 
Dim dtCurrent 

Dim dblCurrent 

Dim lIndex 

Dim vValues (360) 

Dim vTimeStamps (360) 


‘create reference to TrendControl 
Set objTrendControl = ScreenItems("Control2") 


'---- reference trend ---- 

"create reference to new window, time and value axis 

Set objTrendWindow = objTrendControl.GetTrendWindowCollection.AddItem("myWindow") 
Set objTimeAxis = objTrendControl.GetTimeAxisCollection.AddItem("myRefTimeAxis") 
Set objValueAxis = objTrendControl.GetValueAxisCollection.AddItem("myRefValueAxis") 


‘assign time and value axis to the window 
objTimeAxis.TrendWindow = objTrendWindow.Name 
objTimeAxis.ShowDate = False 
objValueAxis.TrendWindow = objTrendWindow.Name 


‘add trend and assign propertys 

Set objTrend = objTrendControl.GetTrendCollection.AddItem("myRefTrend") 
objTrend.Provider = 0 

objTrend.Color = RGB(0,0,0) 

objTrend.TrendWindow = objTrendWindow.Name 

objTrend.TimeAxis = objTimeAxis.Name 

objTrend.ValueAxis = objValueAxis.Name 


"generate values for reference trend 
dtCurrent = CDate("23.11.2006 00:00:00") 

For lIndex = 0 To 360 

vValues(lIndex) = ( Sin(dblCurrent) * 60 ) + 60 
vTimeStamps (lIndex) = dtCurrent 

dblCurrent = dblCurrent + 0.105 

dtCurrent = dtCurrent + CDate ("00:00:01") 
Next 


‘insert data to the reference trend 
objTrend.RemoveData 
objTrend.InsertData vValues, vTimeStamps 


Neos data trends =s=— 

‘add time and value axis to the existing window 

Set objTimeAxis = objTrendControl.GetTimeAxisCollection.AddItem("myTimeAxis") 
Set objValueAxis = objTrendControl.GetValueAxisCollection.AddItem("myValueAxis") 


‘assign time and value axis to the window 
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objTimeAxis.TrendWindow = objTrendWindow.Name 
objTimeAxis.ShowDate = False 
objValueAxis.TrendWindow = objTrendWindow. Name 


‘add new trend and assign properties 

Set objTrend = objTrendControl.GetTrendCollection.AddItem("myTrend") 
objTrend.Provider = 0 

objTrend.Color = RGB(255,200,0) 

objTrend.Fill = True 

objTrend.TrendWindow = objTrendWindow. Name 

objTrend.TimeAxis = objTimeAxis.Name 

objTrend.ValueAxis = objValueAxis.Name 


"generate values for data trend 
dtCurrent = CDate("23.11.2006 00:00:00") 

For lIndex = 0 To 360 

vValues (lIndex) = ( Sin(dblCurrent) * 60 ) + 60 
vTimeStamps (lIndex) = dtCurrent 

dblCurrent = dblCurrent + 0.106 

dtCurrent = dtCurrent + CDate ("00:00:01") 
Next 


‘insert values to the data trend 
objTrend.RemoveData 
objTrend.InsertData vValues, vTimeStamps 


Result 


Of 


00:05:50 


00:05:10 00:05:30 00:05:40 


VISES) OSEER en Aa 


00:05:10 


00:05:20 


00:05:30 


00:05:20 00:05:40 00:05:50 


Example: How to add elements to a WinCC OnlineTrendControl 


Introduction 


In the following example, insert value columns with properties in an empty WinCC 
OnlineTableControl and link the columns to archive tags. 
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Requirement 


Example 


"VBS351 
im obj 
obj 


Dim 
Dim 
objTrend 


at 


referenc 


An archive is created in the "Tag Logging Editor" with three archive tags. 


A "WinCC OnlineTableControl" with the name "Control2" is inserted in the process picture 
in the Graphics Designer. 


A button is inserted in the Graphics Designer. You have configured the event "mouse click", 
for example, for the button, with a VBS action and the following script. 


TableControl 
TimeColumn 
objValueColumn 


to TableControl and enable BackColor 


set 


objTableControl 
obj TableControl.UseColumnBackColor 


ScreenItems ("Control2") 
True 


"creat 


referenc 
Set objTimeColumn 
objTimeColumn. Length 


to new TimeColumn and assign column length 
objTableControl.GetTimeColumnCollection.AddItem("myRefTimeAxis") 
20 


‘add new ValueColumn and assign propertys 


Set objValueColumn 


objValueColumn 


objValueColumn. 
objValueColumn. 
objValueColumn. 


obj TableControl.GetValueColumnCollection.AddItem("myValueTablel") 


-Provider = 1 

TagName = "Process value archive\PDL ZT 1" 
BackColor = RGB(255,255,255) 

TimeColumn = objTimeColumn.Name 


‘add new ValueColumn and assign propertys 


Set objValueColumn 


objValueColumn 


objValueColumn. 
objValueColumn. 
objValueColumn. 


obj TableControl.GetValueColumnCollection.AddItem("myValueTable2") 


-Provider = 1 

TagName = "Process value archive\PDL ZT 2" 
BackColor = RGB(0,255,255) 

TimeColumn = objTimeColumn.Name 


‘add new ValueColumn and assign propertys 


Set objValueColumn 


objValueColumn 


objValueColumn. 
objValueColumn. 
objValueColumn. 


852 


obj TableControl.GetValueColumnCollection.AddItem("myValueTable3") 


.Provider = 1 

TagName = "Process value archive\PDL ZT 3" 
BackColor = RGB(255,255,0) 

TimeColumn = objTimeColumn.Name 
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Result 


EB WinCc OnlineTableControl 


08.02.2010 14:15:03 
08.02.2010 14:15:03 


Example: Scripts for WinCC AlarmControl 


Introduction 
The following examples demonstrate the use of scripts for WinCC AlarmControl. 


Requirement 
e You have already configured messages in the "Alarm Logging" editor. 


Example 1: Setting filters 


A filter with message number "2" is set, or reset if the filter has already been set. The status 
is also output in the dialog window. 


'VBS353 
Dim objAlarmControl 
"create reference to AlarmControl 
Set objAlarmControl = ScreenItems("Controlli") 
"set / reset the filter and create a trace 
If (objAlarmControl.MsgFilterSQL = "") Then 
objAlarmControl.MsgFilterSQL = "MSGNR = 2" 
HMIRuntime.Trace "MsgFilterSQL set to MSGNR = 2" & vbNewLine 
Else 
objAlarmControl.MsgFilterSQL = "" 
HMIRuntime.Trace "no filter" & vbNewLine 
End If 
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Example 2: Adding a column to WinCC AlarmContol 


The column "Message text" is added or removed if the column already exists. The status is 
also output in the dialog window. The message block of the "Message text" column has the 
object name "Text1". 


"VBS354 

‘add this function to the declaration section 

Function IsExistingMsgColumn( objAlarmControl, strName ) 
"this function checks if the MessageColumn exists 


on error resume next 
objAlarmControl.GetMessageColumn( strName ) 


If err.number = 0 Then 
IsExistingMsgColumn = True 
else 
err.Clear 
IsExistingMsgColumn = False 
end if 


End Function 


"example code 

Dim objAlarmControl 

Dim colMsgColumn 

"create reference to the alarm control 

Set objAlarmControl = ScreenItems("Controll") 

Set colMsgColumn = objAlarmControl.GetMessageColumnCollection 
add or remove the MsgColumn 

f ( IsExistingMsgColumn(objAlarmControl, "Textl") ) Then 
HMIRuntime.Trace "Remove MsgColumn" & vbNewLine 
colMsgColumn.Removeltem("Text1") 

Else 
TRuntime.Trace "Add MsgColumn" & vbNewLine 
colMsgColumn.AddiItem("Text1") 

End If 


aa 


Example 3: Output content of message window in dialog window 


'VBS355 

Dim objAlarmControl 

Dim lIndex 

Dim 1CellIndex 

"create reference to the alarm control 

Set objAlarmControl = ScreenItems("Controll") 


"enumerate and trace out row numbers 

For lIndex = 1 To objAlarmControl.GetRowCollection.Count 

HMTRuntime.trace "Row: " & (objAlarmControl.GetRow(lIndex).RowNumber) & " " 
‘enumerate and trace out column titles and cell texts 

For 1CellIndex = 1 To objAlarmControl.GetRow(lIndex) .CellCount 
HMTIRuntime.trace objAlarmControl.GetMessageColumn(1CellIndex -1).Name & " " 
HMIRuntime.trace objAlarmControl.GetRow(lIndex) .CellText (1CellIndex) & " a 
Next 

HMTRuntime.trace vbNewLin 

Next 
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1.15.3 General Examples 
1.15.3.1 General examples for VBScript 
Introduction 


This section contains examples of the general use of VBScript with regard to the following 
topics: 


@ Program data connection with VBS 
e Toretrieve methods 
e Using the MS Automation Interface 


e Starting External Applications 


Note 


All objects supplied with the Windows Script Host (WSH) from Microsoft can be integrated in 
their environment using the standard VBS method "CreateObject". However, there is no direct 
access to the WSH object itself using VBS from WinCC. 


Example 1: "FileSystemObject" object for working with the file system 

Dim fso, MyFile 

Set fso = CreateObject ("Scripting.FileSystemObject") 

Set MyFile = fso.CreateTextFile("c:\testfile.txt", True) 
MyFile.WriteLine("This is a test.") 

MyFile.Close 


Example 2: "WScript.Shell"-Object for working with the Windows environment 


See also 
Example: Configuring a Database Connection with VBS (Page 856) 
Example: Starting an external application (Page 859) 
Example: Using the MS Automation interface (Page 858) 
Example: Calling Methods of an ActiveX Control (Page 841) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 855 


VBS for Creating Procedures and Actions 
7.15 Examples of VBScript 


1.15.3.2 Example: Configuring a Database Connection with VBS 


Introduction 


The following examples describe the configuration of an Access database link via an ODBC 
driver. 


e Example 1 writes a tag value from WinCC in an Access database. 
e Example 2 reads a value from the database and writes it in a WinCC tag. 


The examples do not contain any handling faults. 


Procedure, Example 1 


1. Create the Access database with the WINCC_DATA table and columns (ID, TagValue) with 
the ID as the Auto Value. 


2. Set up the ODBC data source with the name "SampleDSN", reference to the above Access 
database. 


3. Programming. 


Example 1 


"VBS108 

Dim objConnection 

Dim strConnectionString 
Dim lngValue 


Dim strSQL 

Dim objCommand 

strConnectionString = "Provider=MSDASQOL; DSN=SampleDSN; UID=; PWD=; " 
IngValue = HMIRuntime.Tags ("Tagl") .Read 

strSQL = "INSERT INTO WINCC_DATA (TagValue) VALUES (" & IngValue & ");" 
Set objConnection = CreateObject ("ADODB.Connection") 
objConnection.ConnectionString = strConnectionString 


objConnection. Open 
Set objCommand = CreateObject ("ADODB.Command") 
With objCommand 


-ActiveConnection = objConnection 
-CommandText = strSQL 
End With 


objCommand.Execute 

Set objCommand = Nothing 
objConnection.Close 

Set objConnection = Nothing 
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Example 2 


"'VBS108a 


1. 
2. 


TagValue (ID as auto value). 


database. 


Programming. 


Dim objConnection 


Dim objCommand 


Dim objRecordset 
Dim strConnectionString 


Dim strSQL 
Dim lngValue 
Dim IngCount 


strConnectionString = "Provider=MSDASOL; DSN=SampleDSN; UID=; PWD=; " 


Create the WinCC tag with the name dbValue. 
Create Access database with WINCC_DATA table and ID, TagValue columns: ID, create 


strSQL = "select TagValue from WINCC_DATA where ID = 1" 
Set objConnection = CreateObject ("ADODB.Connection") 


objConnection.ConnectionString = strConnectionString 
objConnection. Open 
Set objRecordset = CreateObject ("ADODB.Recordset") 


Set objCommand 


CreateObject ("ADODB.Command") 


objCommand.ActiveConnection = objConnection 


objCommand.CommandText = strSQL 


Set objRecordset = objCommand.Execute 


IngCount = objRecordset.Fields.Count 


If (IngCount>0) 


Then 


objRecordset.movefirst 


IngValue = objRecordset.Fields (0) .Value 


Else 


End If 
Set objCommand 


HMIRuntime.Trace 


HMTRuntime.Tags("dbValue") .Write IngValue 


"Selection returned no fields" 


Nothing 


objConnection.Close 


Set objRecordset = Nothing 
Set objConnection = Nothing 


& vbNewLine 


7.15 Examples of VBScript 


Set up the ODBC data source with the name "SampleDSN", reference to the above Access 


There are several ways in which to define the ConnectionString for the connection depending 


ie) 


n the provider used: 
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Microsoft OLE DB provider for ODBC 
Enables connections to any ODBC data source. The corresponding syntax is: 


"[Provider=MSDASQL; ] {DSN=name|FileDSN=filename}; 
[DATABASE=database; ]UID=user; PWD=password" 


Other Microsoft OLE DB Providers (e.g. MS Jet, MS SQL Server) 
It is possible to work without DSN. The corresponding syntax is: 


"[Provider=provider; ] DRIVER=driver; SERVER=server; 
DATABASE=database; UID=user; PWD=password" 


See also 


1.15.3.3 


Introduction 


General examples for VBScript (Page 855) 


Example: Using the MS Automation interface 


The following three examples illustrate how to use the MS Automation interface. 


Example 1: MS Excel 


"'VBS113 


In this example, an output value from an input field is written in an Excel table. 


Dim objJExcelApp 


Set objExcelApp = CreateObject ("Excel.Application") 


objExcelApp. 


objJExcelApp. 
objExcelApp. 
objExcelApp. 
objJExcelApp. 
objExcelApp. 


Visible = True 


'ExcelExample.xls is to create befor xecuting this procedure. 
"Replace <path> with the real path of the file ExcelExample.xls. 


Workbooks.Open "<path>\ExcelExample.xls" 

Cells(4, 3).Value = ScreenItems ("IOField1") .OutputValue 
ActiveWorkbook.Save 

Workbooks.Close 

Quit 


Set objExcelApp = Nothing 
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Example 2: MS Access 
This example opens a report from MS Access. 


'VBS114 

Dim objAccessApp 

Set objAccessApp = CreateObject ("Access.Application") 
objAccessApp.Visible = True 

' 

"DbSample.mdb and RPT WINCC_DATA have to create befor xecuting 
‘this procedure. 

"Replace <path> with the real path of the database DbSample.mdb. 
objAccessApp.OpenCurrentDatabase "<path>\DbSample.mdb", False 
objAccessApp.DoCmd.OpenReport "RPT WINCC_ DATA", 2 
objAccessApp.CloseCurrentDatabase 

Set objAccessApp = Nothing 


Example 3: MS Internet Explorer 
This example opens the MS IE. 


'VBS115 

Dim objIE 

Set objIE = CreateObject ("InternetExplorer.Application") 
objIE.Navigate "http://www.siemens.de" 
Do 

Loop While objIE.Busy 

obj JIE.Resizable = Tru 

objIE.Width = 500 

objJIE.Height = 500 

objIE.Left = 0 

objIE.Top = 0 

objJIE.Visible = True 

See also 


General examples for VBScript (Page 855) 


1.15.3.4 Example: Starting an external application 


Introduction 


The following two examples illustrate how to start an external application. 
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'VBS117 


Dim objWshShell 
Set objWshShell = CreateObject ("Wscript.Shell") 
Example.txt", 1 


objWshShell.Run "Notepad 


See also 
General examples for VBScript (Page 855) 
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1.16 Basic Principles of VBScript 
1.16.1 Basic Principles of VBScript 
Introduction 


The most important topics of the Microsoft VBScript Reference are provided below: 
e VBScript Language Directory 

e VBScript Tutorial with the most important basic principles 

© Scripting runtime reference 

If a full version of the VBScript Reference is required, it is available under 


http://msdn2.microsoft.com/en-us/library/tOaew7h6 (http://msdn2.microsoft.com/en-us/library/ 
tOaew7h6) 


See also 


Microsoft VBScript Reference (http://msdn2.microsoft.com/en-us/library/t0aew7h6) 


1.16.2 VBScript Basics 
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2.1 Creating Functions and Actions with ANSI-C 


Contents 


In Runtime, background tasks, such as printing daily reports, monitoring tags or performing 
picture-specific calculations, are performed as actions. 


These actions are started by triggers. 


Functions can be called from actions. WinCC has a multitude of functions, which can be 
modified by the user. Furthermore, the user can also develop his own functions. 


The Global Script editor is used to create and edit functions and actions. 
This chapter will show you 

@ How to use the Global Script editor 

e How to create and edit functions 

e How to create and edit actions 


e How to use the diagnostic tools to analyze runtime problems 
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2.2 Creating Functions and Actions 
2.2 Creating Functions and Actions 


Introduction 


WinCC supports the use of functions and actions for dynamization of the processes in your 
WinCC project. These functions and actions are written in ANSI-C. 


Difference between Functions and Actions 


Actions are activated by a trigger, namely a triggering event. Functions do not have a trigger 
and are used as components of actions as well as in Dynamic Dialogs, in Tag Logging and in 
Alarm Logging. 


function 
C Code 


Trigger Types 


The following trigger types are available: 


Trigger Type 


Timer Variable 


Cyclical 


(Repeated execution at 
uniform intervals) 


Acyclical 
(Single execution, Starting point Cyclical 
starting point specified by specified by Periodic monitoring of the By change 


variable's value 


Date/Time) Day: Month: Time 
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2.2 Creating Functions and Actions 


Outline of the Functions and Actions 


The diagram provides an overview of the range of functions and actions: 


Functions and 


Actions 


Included : . 
Internal Standard Project Standard DLL Global igiead alt 
functions functions functions functions functions actions See 


Actions are used for picture-independent background tasks, such as printing daily reports, 
monitoring tags or performing calculations. 


Functions are pieces of code, which can be used in several locations, but are only defined in 
one place. WinCC includes a multitude of functions. Furthermore, you can also write your own 
functions and actions. 


The included standard functions can be modified by the user. In the event that WinCC is 
reinstalled or upgraded, the standard functions that were modified are deleted or replaced by 
the unedited standard functions. Therefore, you should back up the modified functions prior 
to upgrading or reinstalling. 


Design tool 


WinCC provides the "Global Script" editor for designing, creating and editing functions and 
actions. Global Script is started from the navigation window of WinCC Explorer. 


Unicode support 


You can set the suitable code page in the toolbar of the "Global Script" editor. This means that 
the system language no longer has to be changed with the Microsoft setting "Start > Settings 
> Control Panel > Regional and Language Options". 


You can select "Dynamic: Project setting" as the language setting for scripts. The C script is 
compiled in English. The code page of the centrally configured language is used for the strings 
in runtime. 
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See also 


866 


You can specify the project setting in the "Project Properties" dialog in the WinCC Explorer. 
You can select the following from a list in the "Options" under "C scripts with "Dynamic" 
language setting in runtime": 


e "Respective set WinCC Runtime language". The C script is executed in the WinCC Runtime 
language. 


@ Operating system language for non-Unicode programs. 


e The C script is executed with the code page setting of the operating system. Select the 
language from the list. 


Runtime Behavior of Actions (Page 927) 

How To Create and Edit Actions (Page 905) 
Creating and Editing Functions (Page 892) 

The Global Script Editor (Page 878) 

Use of DLLs in Functions and Actions (Page 876) 
Use of Global C-Tags (Page 874) 

How to Add Global Script Runtime to a Project's Startup List (Page 873) 
How to Generate a New Header (Page 887) 
Characteristics of Global Actions (Page 872) 
Characteristics of Local Actions (Page 871) 
Characteristics of Internal Functions (Page 870) 
Characteristics of Standard Functions (Page 868) 
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2.3 Characteristics of Project Functions 


Characteristics of Project Functions 


Project functions ... 


Project functions are saved in the "\library 


can be created by yourself 

can be edited by you 

can be password-protected against modification and viewing by unauthorized persons 
have no trigger 

are only known within the project 

are assigned file name extension "*.fct" 


subdirectory of the WinCC project. 


=). 4 Project path 


J library 


Use of Project Functions 


Project functions can be used... 


See also 


in other project functions 

in Global Script actions 

in C-Actions in the Graphics Designer and within the Dynamic Dialog 
in Alarm Logging within the Loop in Alarm functionality 


in Tag Logging when starting and releasing archives and when swapping-out cyclic archives 


How to Protect a Function Against Unauthorized Access (Page 900) 


Creating and Editing Functions (Page 892) 
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2.4 Characteristics of Standard Functions 


Characteristics of Standard Functions 
Standard functions ... 
e are provided for use in WinCC 
® cannot be created by yourself 
@ can be edited by you 
® can be password-protected against modification and viewing by unauthorized persons 
e have no trigger 
® are known across projects 


@ are assigned file name extension "*.fct" 


Standard functions are saved in the "\aplib" subdirectories in the WinCC installation directory. 


=}-__] Installation path 


__} Graphics 
__j Report 
_ | TagLog 
yy ¥vincc 
Windows 


Use of Standard Functions 
Standard functions can be used... 
e in project functions 
e in other standard functions 
e in Global Script actions 
e in C-actions in the Graphics Designer and within the Dynamic Dialog 
e in Alarm Logging within the Loop in Alarm functionality 


e in Tag Logging when starting and releasing archives and when swapping-out cyclic archives 
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Note 


The included standard functions can be edited by the user. In the event that WinCC is 
reinstalled or upgraded, the standard functions that were modified are deleted or replaced by 
the unedited standard functions. Therefore, you should back up the modified functions prior 
to upgrading or reinstalling. 


See also 
How to Use Standard and Project Functions (Page 897) 
Creating and Editing Functions (Page 892) 
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2.5 Characteristics of Internal Functions 


Characteristics of Internal Functions 
Internal functions ... 
e@ are provided for use in WinCC 
® cannot be created by you 
e cannot be edited 
® cannot be renamed 
e have no trigger 
e are know project-wide 


We 


@ are assigned file name extension "*.icf" 


Internal functions are saved in the "\aplib" subdirectories in the WinCC installation directory. 
=}-__] Installation path 


“9 aplib 
J Allocate 
wn) C-bib 
_) Graphics 


__jTag 
“ywinec 


Use of Internal Functions 
Internal functions can be used... 
e in project functions 
e in standard functions 
e in actions 


@ in C-actions in the Graphics Designer and within the Dynamic Dialog 
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2.6 Characteristics of Local Actions 


Characteristics of Local Actions 
Local actions ... 
©@ can be created by yourself 
@ can be edited by you 
e@ can be password-protected against modification and viewing by unauthorized persons 
e@ have atleast one trigger 
@ are only executed on the assigned computer 


We 


@ are assigned file name extension "*.pas" 


Local actions are saved in the "\<computer_name\Pas" subdirectory in the project directory. 
=)-__} Project path 
4 «System Name= 


| Pas 


Use of Local Actions 


Actions are used for picture-independent background tasks, such as printing daily reports, 
monitoring tags or performing calculations. An action is started by the trigger configured for it. 
In order for an action to be executed, Global Script Runtime must be included in the startup 
list. 


In contrast to global actions, local actions can be assigned to a single computer. It is thus for 
example possible to ensure that a report is only printed on the server. 


See also 
How to Protect an Action Against Unauthorized Access (Page 912) 
Triggers (Page 914) 
How To Create and Edit Actions (Page 905) 
How to Add Global Script Runtime to a Project's Startup List (Page 873) 
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2.7 Characteristics of Global Actions 


Characteristics of Global Actions 
Global actions ... 
@ can be created by yourself 
® can be edited by you 
® can be password-protected against modification and viewing by unauthorized persons 
e have at least one trigger to start them 
e are executed on all project computers in a client-server project 


e@ are assigned file name extension "*.pas" 


Global Actions are saved in the "\Pas" subdirectory of the WinCC project. 


=) Project path 


| Pas 


Use of Global Actions 


Actions are used for background tasks, such as printing daily reports, monitoring tags or 
performing calculations. An action is started by the trigger configured for it. In order for an 
action to be executed, Global Script Runtime must be included in the startup list. 


In contrast to local actions, global actions are executed on all project computers in a client- 
server project. In a single-user project there is no difference between global and local actions. 


See also 
How to Protect an Action Against Unauthorized Access (Page 912) 
Triggers (Page 914) 
How To Create and Edit Actions (Page 905) 
How to Add Global Script Runtime to a Project's Startup List (Page 873) 
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Introduction 


Procedure 


2.8 How to Add Global Script Runtime to a Project's Startup List 


How to Add Global Script Runtime to a Project's Startup List 


In order to run Global Script Actions in Runtime, Global Script Runtime must be added to the 
project's startup list. This does not affect the executability of the functions. 


1. Inthe shortcut menu of computer in WinCC Explorer, select "Properties". The "Computer 
list properties" dialog opens. 


2. Click "Properties". The "Computer Properties" dialog opens. 


3. Select the "Startup" tab 


4. Activate "Global Script Runtime". 


Computer properties 


General | Startup | Parameters Graphics Runtime | Runtime 


WinCC Runtime Start Up Order: 


1 |Alarm Logging Runtime 
Tag Logging Runtime 

|] Report Runtime 

(V| Graphics Runtime 


Additional Tasks/Applications: 


YJ Global Script Runtime =| 


| ]Message Sequence Report /SEQPROT = a 


Sequence of WinCC tasks that are started when the WinCC project is activated. 


Ww 


Im 


5. Click "OK" to close the dialog. 
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2.9 


Use of Global C-Tags 


Definition of global C tags 


Validity range 


A global C-tag is defined by adding the definition line in front of the function name of a function: 


int a; //The tag a is defined as an integer 
void dummy() //Function name 
{ 


//Function code 


A tag defined in this manner is known to every function and action in Runtime. It is created as 
soon as Runtime is started, even if the function itself was not called. 


Note 


When you operate the WinCC Service Mode, there is no common data area for C scripting. 
Thus, for example, no global C variables can be exchanged between "Global Script" and the 
"Graphics Designer". 


Use of global C tags 
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Global C tags are used in functions or actions by declaring them as external within the function 
or action: 


void dummy() //Function name 


{ 


extern int a; //External declaration of the tag a 


//Function code 


} 


The compiler is thus informed that it need not create the tag, since it is created in another 
location in Runtime. 


If the value of tag a changes, this change can be read by every function and action. 


Each C-tag may only be defined in one location. For reasons of clarity and to avoid duplicate 
definitions, we recommend defining global C tags in only one location. 
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Note 


A maximum of 64 Kbytes are available to a function and the global C-tag defined with it. 
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2.10 Use of DLLs in Functions and Actions 


Adjusting DLLs 
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WinCC allows you to use your own DLLs (Dynamic Link Libraries). 


Functions in existing DLLs can be enabled for functions and actions by making the necessary 
additions to the respective function or action. 


Add the following code in front of the function or action: 


#pragma code ("<Name>.d1ll1") 


<Type of returned value> <Function name 1>(...); 
<Type of returned value> <Function name2>(...); 
<Type of returned value> <Function name n>(...); 


#pragma code () 


The functions <Function_name 1> ... <Function_name n> from <Name.dll> are declared and 
can now be called by the respective function or action. 


Example: 


#pragma code("kernel32.d11") 


VOID GetLocalTime (LPSYSTEMTIME lpSystemTime) ; 


#pragma code () 


SYSTEMTIME st; 


GetLocalTime (&st) ; 


As an alternative to this procedure, you can also make the necessary additions in the 
"Apdefap.h" header file. 


When using own DLLs in WinCC, you must use the release version. WinCC is delivered as a 
release version and thus uses the release version of the system DLLs. If you generate a custom 
DLL in the debug version, it is possible that both the release and the debug version of the DLL 
are loaded, increasing the memory requirements. 
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Structures of the DLL have to be set up using 1-byte alignment. 


Note 


The DLL must be saved in either the "\bin" directory or in a path defined in the "PATH" system 
tag. This tag is defined in the operating system properties. 
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2.11 The Global Script Editor 
2.11.1 The Global Script Editor 
Introduction 


WinCC supports the creation and editing of functions and actions with the Global Script editor. 
Global Script is started from the project window of WinCC Explorer. 


Structure of the Global Script Editor 


The Global Script editor is designed in accordance with the Windows standards. It comes with 
toolbars, a menu bar and a status bar. It has several windows featuring drop-down menus. 


© Global Script C - (new1.mcp) 


@—+ File Edit Yiew Window Options Help 
o— : F 3 he? 2 ne ic} mane English (United States) + [ ) i >| _» i 

{ ) Standard Function : getlocalpicture.Fct Actions xX _ Vv 
#22} Project Functions ~ Hinclude "apdefap.h" : ae | 


3] Standard Functions 


8-425} Alarm re gscAction[ void 
ray 453] S 
Eiiper renerree pen gee 7/WANCC:TAGNAME_SECTION_START 
( 3 --— FEE} GRAPHICS #? syntax: #define TagNamelnAction "DMT agName" 
#2) GetLinkedariable #? next TaglD : 1 
#2) GetLocalPicture ##WINCC:TAGNAME_SECTION_END 


re 
2) GetParentPicture //WINCC:PICNAME_SECTION_START 


REE i i 3 5 7 : 
#2 _GetParentPictureWindow /# syntax: Hdefine PicNamelnAction "PictureName" 


#) OpenPicture ## next PiclD : 1 
#) Registry2 /? WINCC:PICNAME_SECTION_END 


422) 


Obsolete Functions 
=; Options 


return 0; 


(H-se=; Report 
E>) Split Screen Manager Compiling 
GH se) UserArc O Error(s}, 0 Warninats) 
Hs} WINCC 
H-=3} WINDOWS 
$5] Internal functions é 
=) 52 Actions S= 
$5q Actions : SIEMENSAG Output Window =Stoe 


$34 Global actions 


©——@tess Fi for Help. 


Menu bar (1) 
The menu bar content depends on the situation. It is always visible. 


Toolbars (2) 
Global Script contains two toolbars You may always unhide these toolbars and use the mouse 
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to move them to any screen position. 
You may hide/unhide the toolbars using the "View" > "Toolbars" menu command and move 
these to any position in the editor. 


Navigation window (3) 

The navigation window serves to select functions and actions for editing, or to insert an editing 
window atthe cursor position. The functions and actions are organized in groups with hierarchic 
order. Functions are always displayed by their function name, while actions are displayed by 
their file name. 


Editing window (4) 

The editing window is used to edit functions and actions. It is only visible when a function or 
action has been opened for editing. Each function or action is opened in a separate edit 
window. Several editing windows can be opened simultaneously. 


Output window (5) 
The output window displays results of the "Search in files" or "Compile all functions" functions. 
By default, it is visible, but can be hidden. 


@ Search in files: 
A hit list is returned for each search term found in a single line of the output window, which 
consists of the line number, path and file name, as well as the line text with the specified 
number of the line in which the search term was found. You can directly open the 
corresponding file by double-clicking an entry in the output window. The cursor is placed 
in the line in which the search term was found. 


@ Compile All Functions: 
Compiler warnings and error messages are output for all functions compiled. In the next 
line, the path and file name of the compiled function as well as the summary message from 
the compiler are displayed. 


Status bar (6) 

The status bar is located on the bottom edge of the Global Script window; you may hide/unhide 
the status bar. It contains information about the position of the cursor in the edit window and 
the keyboard settings. In addition, the status bar shows either a brief description for the 
currently selected Global Script functionality or a tip. 


Window docking 


w~ax 


Window docking is a useful tool for the flexible arrangement of windows. It lets you reposition 
windows to obtain separate windows, or to group windows in tab groups. For example, you 
can arrange your actions horizontally, vertically, or as tab group. You may hide windows 
automatically and show these again as required. 

For more information ,refer to chapter "Creating process pictures". 


See also 
Printing Functions and Actions (Page 890) 
How to Search in Files (Page 889) 
How to Compile All Functions (Page 888) 


How to Generate a New Header (Page 887) 
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How to Delete Actions or Project and Standard Functions (Page 887) 
How to Use "Save As..." (Page 886) 

How to Set the Font Style (Page 885) 

How to Set Different Views (Page 885) 

Working with the Toolbars (Page 882) 

Working in the Edit Window (Page 880) 


2.11.2 Working in the Edit Window 
2.11.2.1 Working in the Edit Window 
Introduction 


The edit window includes an array of functions, which can be executed with either the keyboard 
or the mouse. 


In the edit window, you can edit functions and actions. 


Standard Function : getlocalpicture.Fct ‘Actions Xx | tad 


#include "apdefap.h" 
int gscAction{ void ] 


#? WANCC:TAGNAME_SECTION_START 

?/ syntax: Hdefine TagNamelnAction "DMT agN ame" 
#/ next TaglD : 1 

#? WINCC:TAGNASME_SECTION_END 


#? WINCC:PICNAME_SECTION_START 

?? syntax: Hdefine PicNamelnéction "PictureN ame" 
#? next PiclD : 1 

#? WINCC:PICNAME_SECTION_END 


return O; 


Compiling... 
O Error(s), 0 Warning(s) 


< 


lv 


Contents 


The window can be split. The upper part of the edit window displays the code of the function 
or action. In the lower part, you can see the messages that the compiler output while compiling 
the function or action. 
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Properties 


Color code 


See also 


2.11.2.2 


2.11 The Global Script Editor 


When the window is opened for the first time, the lower part of the window is minimized. When 
the compiler process is started, the lower part of the window is enlarged to allow for the display 
of the compiler messages. The division of the window can be adjusted with the mouse. Double- 
click an error message to jump to the corresponding line in the code. 


The C code is color-coded as follows: 


Color Description Example 

Blue Keywords define, double, if 

Green Comments // is acomment 

Red Strings "Rectangle3" 

Black Other C-codes level=100*newvalue/255; 
Note 


A function or action cannot have more than 32767 characters including spaces. 
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Editing Functions with the Keyboard (Page 881) 


Editing Functions with the Keyboard 


You can carry out the following editing functions using the keyboard: 


of text 


Editing function Keyboard operation 
Switch between write modes Insert/Overwrite <INSERT> 

Add new line <ENTER> 

Delete one character to the right <DELETE> 

Delete one character to the left <BACKSPACE> 
Delete marked text <DELETE> or <BACKSPACE> 
Jump to beginning of line <POS1> 

Jump to end of line <END> 

Jump to beginning of text <CTRL+POS1> 
Jump to end of text <CTRL+END> 
Move cursor <Cursor keys> 
Move cursor by one window content to beginning | <PAGE UP> 


Move cursor by one window content to end of text 


<PAGE DOWN> 


Move cursor to first line in window 


<CTRL+PAGE UP> 
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2.11.2.3 


2.11.3 


Purpose 
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Editing function Keyboard operation 
Move cursor to last line in window <CTRL+PAGE DOWN> 


Jump to next tab position <TAB> 


Cut marked text and paste to clipboard <CTRL+X> 


Copy marked text to clipboard <CTRL+C> 
Paste text from clipboard <CTRL+V> 


Editing Functions with the Mouse 


You can carry out the following editing functions using the mouse: 


Editing function Mouse command (left mouse button) 
Select text Drag mouse over text 

Select a word Double-click the word 

Select a line Triple-click the line 

Extended selection <SHIFT> + mouse-click 

Set cursor Click 

Move selected text Drag and drop 

Duplicate selected text <CTRL>+drag and drop 


Other editing functions: 


e By double-clicking a compiler error message, the editor jumps to the corresponding line in 
the code. 


e Right-clicking calls up a shortcut menu. 


With the following actions, the selected text is replaced by the result of the action: 
e@ Input of character(s) through the keyboard 
e Pasting of text from the clipboard 


e Insertion of a function call by means of parameter assignment 


Working with the Toolbars 


The toolbars are located in their default position below the menu bar, at the top of the Global 
Script window. The toolbar buttons allow for fast and easy execution to a number of Global 
Script functions. 


There are two toolbars available: 


"Standard" toolbar 
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8 3 3 oF ed 23 DO sR? BS Be 


"Edit" toolbar 


ft} £4} Deutsch (Deutschland) + () >] » 


Contents 


The standard toolbar contains buttons for the following functions: 


Button Function Key combination 

iB Creates a new action. <ALT+A> or 
<CTRL+N> 

iB Creates a new standard function. <ALT+S> or 
<CTRL+N> 

2 Creates a new project function. <ALT+P> or 
<CTRL+N> 

= Creates a new header file. <CTRL+H> 

eS Opens an existing action or function. <CTRL+O> 

lA Saves the content of the active editing window. This func- | <CTRL+S> 


tion is only available if an editing window is open. 


% Cuts the selected text and copies it to the clipboard. This | <CTRL+X> 
function is only available if text has been selected. 

2a Copies the selected text to the clipboard. This function is | <CTRL+C> 
only available if text has been selected. 
Pastes the contents of the clipboard at the location of the | <CTRL+V> 
cursor. This function is only available if the clipboard is not 
empty. 

“) Undoes the last of a maximum of 30 editor actions. This | <CTRL+Z> 
function is only available if an editor action has been per- 
formed. 

ites Redoes the last editor action that was undone. This func- | <CTRL+A> 
tion is only available if an editor action has been undone. 

= Prints the contents of the active editing window as project | <CTRL+P> 
documentation. This function is only available if an editing 
window is open. 

h? Activates the direct help (What's this?). <SHIFT+F1> 

2 Generates a new header. <CTRL+G> 

4 Allows you to set the font. <CTRL+F> 
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Note 


The key combination <CTRL+N> is only available if at least one editing window is open. If the 


active editing window contains a function and <CTRL+N> is pressed, a new project function 


is created. If the active editing window contains an action, this key combination creates a new 
global action. 


The editing toolbar contains buttons for the following functions: 


Function 


Enables you to add information 
about functions and, in the case 
of an action, to setup a trigger. 
This function is only available if 
an editing window is open. 


Key combination 
<CTRL+I> 


Compiles the code in the active 
editing window. This function is 
only available if an editing win- 
dow is open. 


<SHIFT+F8> 


English (United States) 


¥ 


Set the appropriate code page. 


Verify that the code page selec- 
tion matches the source text. 
You cannot use more than one 
language in the source text. 


Opens the tag dialog. This func- 
tion is only available if an editing 
window is open. 


<CTRL+R> 


Opens a dialog for the selection 
of a picture. The name of the se- 
lected picture is inserted at the 
position of the cursor in the edit- 
ing window. This function is only 
available if an editing window is 
open. 


<CTRL+W> 


2) 


Imports an action. This function 
is only available if the active win- 
dow contains an action. 


<CTRL+M> 


Exports the action from the ac- 
tive editing window. This function 
is only available if the active win- 
dow contains an action. 


Sets the authorization for operat- 
ing the action. This function is 
only available if the active win- 
dow contains an action. 


<CTRL+T> 


<CTRL+E> 


Properties 


Both toolbars can be shown or hidden. 
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See also 


2.11.4 


Introduction 


Procedure 


2.11.5 


Introduction 


Procedure 


2.11 The Global Script Editor 


They can be pinned below the menu bar. 


When they are not pinned down, they can be dragged with the mouse to any position on the 
screen. 


How to Set Different Views (Page 885) 


How to Set Different Views 


In this context, views are considered to be different combinations of elements visible in the 
Global Script editor, such as the output window, status bar and toolbars. These elements can 
be individually displayed or hidden. 


By default, all elements are visible. 


1. Opens the "View" menu in the Global Script menu bar. 


2. Activate or deactivate the display of the desired elements e.g. the toolbars. If "show" is 
chosen, a check mark is displayed in front of the name. 


Note 


When Global Script restarted, the editor reverts to the default settings and all elements are 
again visible. 


How to Set the Font Style 


The font style is composed of the settings "Font", "Style" and "Size". 


The style selected is active in all edit windows. 


1. Click the 4g button in the standard toolbar to open the dialog for setting the font style. 
2. Make the desired settings. 
3. Confirm your settings by clicking "OK". 
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Alternative procedure 


2.11.6 


Introduction 


Requirement 


Procedure 


See also 
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You can also open the dialog for the font style settings in the following manner: 


Select the "Options" menu in the Global Scripts menu bar and select "Font", or use the 
corresponding key combination. 


Note 


The settings are automatically saved and are not reset when WinCC is restarted. 


How to Use "Save As..." 


If a function or action is created, Global Script saves the corresponding file in a predefined 
path with a default file name, e.g. "new_function_1.fct" for functions and "gsccs1.pas" for 
actions. Since these default file names are not particularly useful, use "Save As ..." to save 
the function or action under a different - more meaningful - file name. The file with the default 
file name is retained. 


With "Save As ...", only the file name is changed, the function or action name remains 
unchanged. 


Global Script expects that the function or action is saved in a project directory. If this is not 
the case, a message is displayed, but the file is saved nonetheless. 


"Save As..." is only available, if at least one edit window is open. It saves the content of the 
active edit window. 


. Inthe Global Script menu bar, open the "File" menu. 
. Select "Save As...". 


. Enter the new file name. 


RW DN = 


. Close the dialog by clicking the "Save" button. 


How to Delete Actions or Project and Standard Functions (Page 887) 
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2.11.7 How to Delete Actions or Project and Standard Functions 


Introduction 


Actions or project and standard functions can be deleted during configuration or in Runtime. 
Global Script deletes the entry in the navigation window as well as the associated file. 


If a deleted function is called by an action, the action is terminated upon calling the function. 


If a Global Script diagnostic window is open at this time, a message is displayed. The 
termination of the action is logged in the "WinCC_Sys_xx.log" diagnostic file (xx = consecutive 
number). This diagnostic file is located in the "Diagnostics" subdirectory of the WinCC 
installation directory. 


Procedure 


1. In the Global Script navigation window, call up the shortcut menu for the function or action 
to be deleted. 


2. Select "Delete". 


3. Confirm the command by clicking "Yes". 


Alternative operation 


Instead of using the shortcut menu, you can also delete the selected function or action by using 
the <DELETE> key. 


Note 


If a function is deleted, the entry in the respective header file is deleted as well. 


2.11.8 How to Generate a New Header 


Introduction 
The header must be generated again in the following cases: 


e After you have copied project functions from a different project to the "library" directory in 
your project path. 


e After you have copied standard functions from another PC to the "aplib" directory or 
subdirectories. 


By regenerating the header, you enter the copied functions in the respective header files. You 
can then use the functions in your project. 


Procedure 
1. Click 3 in the "Standard" toolbar. 
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Alternative operation 
Alternatively, you can start a generation process as follows: 


Open the "Options" menu and select "Regenerate Header" or use the corresponding key 
combination. 


Note 
Once the regeneration is finished, the contents of the navigation window are updated. 


If WinCC is in Runtime, the Runtime system is not influenced by the regeneration of the header. 


2.11.9 How to Compile All Functions 


Introduction 


If you have changed the header files manually, you have to recompile all functions. All project 
functions, standard functions and internal functions are automatically compiled with the menu 
command "Compile all functions". 


If functions are called in other functions, error messages are possible. The reason for this is 
that the called functions have not yet been compiled. These functions must then be compiled 
individually. 


Requirement 


This function is only available, if all edit windows are closed. 


Procedure 
1. Open the "Options" menu. 


2. Select "Compile All Functions". 


Alternative operation 


You can compile all functions using the key combination <ALT+U>. 
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Result 


The results of the individual compilation runs are displayed in the output window, e.g. warnings 
and error messages of the compiler. The path and the file name of the compiled function as 
well as the summary message of the compiler are also displayed. 


Note 


In a multi-user project, the "Compile All Functions" function is not available. Assigning functions 
is no longer possible with these projects. 


The functions compiled in this way will not become active until the next time you start Runtime 
ona WinCC PC. 


2.11.10 How to Search in Files 


Introduction 
All files of the group selected in the navigation window are searched for the specified search 
term. 
The result of the search is displayed in the output window as follows: 
For each found search term, a line is displayed in the output window. This line contains the 
line number of the line in the code in which the search term was found, plus the path and file 
name as well as the line of code itself. 
Standard and project functions as well as actions can be opened by double-clicking the search 
results. The cursor is positioned at the start of the line in which the search term was found. In 
the case of internal functions, the function containing the search term is shown in the navigation 
window and selected. 

Procedure 


. Open the shortcut menu for the group to be searched in the Global Script navigation window. 
. Select "Find in Files". 


. In the dialog, enter the search term to be found. 


RW DN = 


. Click "Find" to start the search. The result of the search is displayed in the output window. 
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2.11.11 


2.11.11.1 


Introduction 


See also 


2.11.11.2 


Introduction 


Requirement 


Procedure 
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Printing Functions and Actions 


Printing Functions and Actions 


Actions or project or standard functions can be printed using specified system layouts. 


This is however only possible, if the function or action to be printed is displayed in the edit 
window. The content of the active edit window is printed. 


The printout can be examined on the screen in page view. 

The printing process can be controlled by a number of print parameters. 
The following system layouts are used: 

® @gsc_pfc.rpl for project functions 

® @gsc_sfc.rpl for standard functions 


® @gsc_act.rpl for actions 


How to Print the Project Documentation (Page 891) 
How to Open Page View (Page 891) 
How to Set the Print Parameters (Page 890) 


How to Set the Print Parameters 


You can modify the printout as follows: 

e By specifying a layout that differs from the standard layout 
e By selecting a page range 

e By selecting a printer selection 


e By printing to file 


At least one edit window must be open. 


1. In the Global Script menu bar, open the "File" menu. 


2. Select "Project Documentation Setup..." 
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3. In the subsequent dialog, adjust the desired settings. 


4. Apply the settings by clicking "OK". 


Note 


The settings are automatically saved and are not reset when WinCC is restarted. 


2.11.11.3 How to Open Page View 


Introduction 
Before you begin printing a function or action, it is sometimes an advantage to first see a 
preview of the printout on the screen (in page view). 
The content of the active edit window is displayed in page view. 

Procedure 


1. In the Global Script menu bar, open the "File" menu. 


2. Select "Project Documentation Setup...". 


2.11.11.4 How to Print the Project Documentation 


Introduction 


You can output the contents of the active edit window to a printer or to a file. The selected print 
parameter settings are applied. 


Procedure 
1. In the Global Script menu bar, open the "File" menu. 


2. Select "Print Project Documentation”. 
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2.12 Creating and Editing Functions 
2.12.1 Creating and Editing Functions 
Introduction 


The system distinguishes between project, standard and internal functions. WinCC is delivered 
with a broad selection of standard and internal functions. Furthermore, you can create your 
own project and standard functions or modify standard functions. Please remember, however, 
that the standard functions included with WinCC are overwritten when WinCC is reinstalled so 
any modifications are lost. 


Internal functions cannot be created or edited. 


Using Functions 


If the same calculation must be performed - with different starting values - in several actions, 
it would be to your advantage to program a function to perform this calculation. Subsequently 
you can simply call this function with the current parameters in the actions. 


This approach has a number of advantages: 
e@ The code is only programmed once. 
@ Modifications are only made at one point, namely in the procedure, not in each action. 


e The action code is shorter and, thus clearer. 
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Action A i Action C 


Code for calculation Code for calculation Code for calculation Code for calculation 
Code for calculation Code for calculation Code for calculation Code for calculation 
Code for calculation Code for calculation Code for calculation Code for calculation 


MyFunction( 

Code for calculation 
Code for calculation 
Code for calculation 


Action A i Action C 


Finding Functions 
To access existing functions or create new ones, you can either use the "File" menu in the 
Global Script navigation window or click the corresponding button in the toolbar. 


Functions are stored in the file system as follows: 


=) Project path 


a | library 


=) Installation path 


“9 aplib 
~~) Aan 
~~) Graphics 
{J Report 
(| TagLog 
wine 
oo) Windows 
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Editing and Compiling Functions 


A function is edited and compiled in its own edit window. The edit window displays messages 
from the compiler after a compilation run. These might be warnings or error messages. In each 
case, a Summary of the number of warnings and error messages is output. 


What Happens When Functions Are Renamed? 


In the navigation window, functions are always displayed with their function not their Windows 
file names. If you change the name of a function and then compile it, the name displayed in 
the navigation window longer match the function name. This is indicated in the navigation 
window with the prefix "*" (asterisk) in front of the name. As soon as you save the function, the 
current function name is displayed in the navigation window. 


Note re. Saving Functions 


See also 
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If you save a function that has not been properly compiled, the P= symbol is shown in the 
navigation window. 


If you save a function that has not been compiled without errors, the = symbol is shown in the 
navigation window. 


Working in the Edit Window (Page 880) 

How to Use Functions from Other Sources (Page 903) 

How to Rename a Function (Page 902) 

How to Compile and Save a Function (Page 901) 

How to Protect a Function Against Unauthorized Access (Page 900) 
Inserting Additional Function-Related Information (Page 898) 
How to Use Standard and Project Functions (Page 897) 
How to Use Internal Functions (Page 897) 

How to Write Function Code (Page 896) 

How to Create a New Function (Page 895) 

Characteristics of Standard Functions (Page 868) 


Characteristics of Project Functions (Page 867) 
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2.12.2 How to Create a New Function 


Introduction 


The procedure is identical for both project and standard functions. In the navigation window, 
specify the type (project or standard function) and, for standard functions, the group, e.g. 
"graphics". This also specifies the place where the file is to be saved. 


Global Script suggests a default name, e.g. "new_function_3", for the new function. This is also 
the file name of the function. To ensure that the function name is unique, the suggested name 
includes a sequential number. 


As a rule, the default name should be replaced with a more informative function name. When 
the renamed function is first saved, the file name can also be changed. 


Global Script adds the following information to the function: date created, date modified and 

version. This information can be viewed in the "Properties" dialog. In the same dialog, you can 
also assign a password to protect the function against unauthorized modification or viewing. 

To open the dialog, click the “4 button. 


Note 


The characters supported by ANSI-C are also supported for the function name: 
e Letters, apart from regional special characters 

@ Numbers 

e Underscore 


Procedure 
1. In the navigation window, open the shortcut menu for the desired group. 


2. Select "New" 
If a new function has been created, the first line of code in the associated edit window 
contains the type of return value and the default name of the new function. In the brackets 
following this, you can enter transfer parameters if you wish. 
The function code is entered between the curly brackets. 


Alternative operation 


Alternatively, you can also create a new function by clicking the associated button in the toolbar, 
via the "File" menu or by using the corresponding key combination. 


See also 
Inserting Additional Function-Related Information (Page 898) 
How to Use "Save As..." (Page 886) 
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2.12.3 


Introduction 


Procedure 


How to Write Function Code 


The function code is written in the edit window for the function. The programming language is 
ANSI-C. 


The code of any project or standard function can call other functions. The called function can 
be a project, standard, internal or DLL function. To make certain that the called function is 
known to the calling function, the line #include "apdefap.h" is added as the first line of code in 
the calling function code. 


In the navigation window under "Internal Functions", the C-function library is available as 
"c_bib". 


The first line of code contains the type of the returned value and the default name of the new 
function. Parameters can be passed by entering them in the following brackets. 


The function code is entered between the braces. 


1. Double-click the function in the navigation window to open it in an edit window. 
2. Set the cursor where you wish to begin writing. 


3. Enter the desired code. 


Alternative operation 


See also 


896 


You can also open a function as follows: 


In the navigation window, open the shortcut menu for the desired action and click "Open" or 
"File\Open...". You can also click the ~ button in the standard toolbar or use the corresponding 
key combination. 


Note 


A maximum of 32 Kbytes of memory is available for local tags (tags defined within the braces 
of the function code). 


How to Use Standard and Project Functions (Page 897) 
How to Use Internal Functions (Page 897) 

Editing Functions with the Mouse (Page 882) 

Editing Functions with the Keyboard (Page 881) 
Working in the Edit Window (Page 880) 
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2.12.4 


Introduction 


Procedure 


2.12 Creating and Editing Functions 


How to Use Internal Functions 


You can use any of the internal functions as part of your function code. The internal functions 
are found in the navigation window in the "Internal Functions" group. 


If you have used the "Assigning Parameters" dialog to add a function, the function's comments 
show the type of value returned. 


1. Place the cursor at the point at which the internal function is to be inserted. 
2. In the navigation window, open the shortcut menu for the internal function to be added. 


3. Select "Assigning Parameters". The "Assigning Parameters" dialog is opened. 
This dialog has one line for each parameter. In the "Value" column, enter the respective 
current parameter. 


4. Inthe "Value" column, enter the current value for each of the required parameters. 
This can be accomplished by either a direct entry from the keyboard, or you can open the 
menu in the "Value" column (single-click and then click the displayed button). From the 
menu, you can open the selection dialog for tags, pictures or graphic objects. 


5. Confirm your entries with "OK". The parameterized function is inserted in the edit window 
at the location of the cursor. 


Alternative operation 


2.12.5 


Introduction 


Alternatively you can also open the "Assigning Parameters" dialog for an internal function by 
double-clicking the function to be added. 


Note 


If you close the "Assigning Parameters" dialog with "OK" without entering the current parameter 
value, the internal function is inserted with its formal parameters. You can then set the 
parameters in the edit window at a later stage. 


Instead of using the "Assigning Parameters" dialog, you can also use the keyboard to enter 
the function. 


How to Use Standard and Project Functions 


You can use any project or standard function as part of the function code, if you have first 
added the line #include "apdefap.h" in the header. The project functions are found in the 
navigation window in the "Project Functions" group. The standard functions are found in the 
navigation window in the "Standard Functions" group. 
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Procedure 


2.12.6 


Introduction 


898 


Project functions are entered in the "Ap_pbib.h" header file; standard functions are entered in 
the "Ap_glob.h" header file. These entries are made by the system. The " Ap_glob.h" header 
file is integrated into the "Ap_pbib.h" header file. The "Ap_pbib.h" header file itself is linked to 
the "Apdefap.h" header file. Therefore all project and standard functions are declared in the 
"Apdefap.h" file header. 


To inform the compiler of the project and standard functions added, add the line #include 
"apdefap.h" as the first line in the function code. 


If you have used the "Assigning Parameters" dialog to add a function, the function comments 
show the type of value returned. 


1. Place the cursor at the point at which the project or standard function is to be inserted. 
2. In the navigation window, open the shortcut menu for the function to be added. 


3. Select "Assigning Parameters". The "Assigning Parameters" dialog is opened. 
This dialog has one line for each parameter. In the "Value" column, enter the respective 
current parameter. 


4. Inthe "Value" column, enter the current value for each of the required parameters. 
This can be accomplished by either a direct entry from the keyboard, or you can open the 
menu in the "Value" column (single-click and then click the displayed button). From the 
menu, you can open the selection dialog for tags, pictures or graphic objects. 


5. Confirm the entries by clicking "OK". 


Note 


If the function does not require a parameter, it is added to the function code immediately without 
opening the "Assigning Parameters" dialog. 


If you close the "Assigning Parameters" dialog with "OK" without entering the current parameter 
value, the internal function is inserted with its formal parameters. You can then set the 
parameters in the edit window at a later stage. 


Inserting Additional Function-Related Information 


Additional information can be assigned to every function. 


When a new action is created, the creation date is automatically entered in the function-related 
information and is unchangeable. In addition, the version number 1.0 is also assigned to the 
number. The version numbers can be individually assigned when editing a function. When a 
function is changed and saved, the current date of change is entered automatically and is 
unchangeable. This dialog can be used to assign a password to protect the function from 
unauthorized viewing and modification. 
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Requirements 
The function to which the information relates must be open in an edit window. 


Procedure 
1. Click the (4 button in the editing toolbar. The "Properties" dialog is opened. 


2. Select the required entries. 
Properties 
Tinto | Trigger 
Created By: 


Creation Date: [29] |2 | |1996 | 


Changed By: | 


Date of change: 31 [3 | 2008 | 


Version: 


Comment : 


3. Confirm the entries by clicking "OK". 


Alternative operation 
Alternatively, the "Properties" dialog can be opened as follows: 


Click the "Edit" menu and select the "Info" option or use the corresponding key combination. 


See also 
How to Protect a Function Against Unauthorized Access (Page 900) 
How to Set Different Views (Page 885) 
Working with the Toolbars (Page 882) 
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2.12.7 


Introduction 


Requirements 


Procedure 


How to Protect a Function Against Unauthorized Access 


Functions can be protected with a password against unauthorized read and write access. The 
password is a part of the function-related information. 


The function to be compiled must be opened in the edit window. 


1. Click the (4 button in the editing toolbar. The "Properties" dialog is opened. 
2. Select the "Password" check box. 
3. Click the "Change" button. 


Password Entry 


Enter a password (max. 10 characters) to prevent 
modification and viewing. 


Password ; 


Confirmation 


4. Enter the password in the "Password" field. 

5. Enter the password again in the "Confirmation" field. 
6. Confirm your entries with "OK". 

7. Click "OK" to close the dialog. 


Alternative operation 


900 


Alternatively, the "Properties" dialog can be opened as follows: 


Click the "Edit" menu and select the "Info" option or use the corresponding key combination. 


Note 


A password-protected function can only be opened in the edit window if the correct password 
is entered. 


To deactivate the password protection, clear the "Password" check box. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


ANSI-C for Creating Functions and Actions 


See also 


2.12.8 


Introduction 


Requirements 


Procedure 


2.12 Creating and Editing Functions 


How to Set Different Views (Page 885) 
Working with the Toolbars (Page 882) 


How to Compile and Save a Function 


In order to use a function, it must first be compiled. Only the function in the active edit window 
is compiled. 


Errors reported by the compiler are displayed in the lower portion of the window. Each message 
is displayed on a separate line. The line includes the line number in the source code where 
the error occurred, a hexadecimal encoded error code and a description of the error. 


Double-click such a line to select the source code line where the error occurred. 


It is recommended that you examine the first message error listed, as subsequent ones could 
be errors resulting from the first one. If the first error is corrected, then the others might 
disappear after the next compilation. 


To make the changes permanent, the function must be saved. 


If you save a function that has been compiled with errors, or not at all, the % icon is assigned 
to this function in the navigation window. 


If you save a function that has been compiled without errors, the {| icon is assigned to this 
function in the navigation window. 


The function to be compiled must be opened in the edit window. 


. Use the toolbar to set the language for compilation of the C function. 
. Click 3 on the "Edit" toolbar. 


. Examine the compiler messages in the lower portion of the edit window. 


RF WwW DN = 


. lf the compiler reported an error, the function code must be corrected. After this has been 
done, start again with step 1 in this table. 


5. If the compiler generated warnings, the function source code may require correction. After 
the code has been corrected, start again with step 1 in this table, otherwise proceed to step 
6. 


6. Click | on the "Default" toolbar. 
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Alternative operation 


See also 


2.12.9 


Introduction 


902 


Alternatively, the compilation process can be initiated in the following ways: 


Select "Compile" from the "Edit" menu, select the "Compile" option from the shortcut menu of 
the edit window or use the corresponding key combination. 


Saving may also be performed in the following ways: 


Select "Save" from the "File" menu or use the corresponding key combination. 


Note 


The compiler does not output an error message if tag names are used several times in a C 
function. This is also the case if a tag name is used both as transfer parameter and as local 
tag definition. 


For example, the following faulty script does not trigger an error message in the compiler: 
void neue Funktion(DWORD dwMyVar) 

{ 

DWORD dwMyVar = 0; 

} 

Message in the output window of the compiler: 

Compiling ... 

0 Error(s), 0 Warning(s) 


Runtime Behavior of Actions (Page 927) 


How to Rename a Function 


It is recommended that you rename the function, when it is created. 


The name of the function in the edit window is then changed accordingly. Since this also 
changes the code, the function must be recompiled. The old function name, displayed in the 
navigation window, is assigned prefix "*" (asterisk). 
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Afterwards, the modified function must be saved at which time you can change the path and 
file name. The old function should then be deleted to avoid accumulating a collection of 
obsolete functions. 


Note 


Please note that only certain characters may be used in function names: characters (with the 
exception of national special characters), numbers and the underscore. 


Procedure 

. Change the function name in the edit window. 

. Click the 333 button in the editing toolbar. The function is compiled. 
. Click the {4 button in the standard toolbar to save the function. 


. If desired, enter a different path and/or file name. 


a F WO DY = 


. Confirm your entry by clicking "Save". 


Alternative operation 
Alternatively, the compilation process can be initiated in the following ways: 


Select "Compile" from the "Edit" menu, select the "Compile" option from the shortcut menu of 
the edit window or use the corresponding keyboard shortcut. 


Saving may also be performed in the following ways: 


Select "Save" from the "File" menu or use the corresponding key combination. 


2.12.10 How to Use Functions from Other Sources 


Introduction 


Project functions from other WinCC projects and standard functions from other WinCC systems 
can also be made useable for the current project. To do so they must be brought into the 
current project. 


Apart from the location in the file system in which they are saved, there is no difference in the 
procedure for project or standard functions. 


Procedure 


1. Copy the functions. Project functions are copied in the "\library" directory for the WinCC 
project. Standard functions are copied in the "\aplib\..." directory in the WinCC path. The 
content of the navigation window is updated automatically. 


2. Click 3) in the "Standard" toolbar. When the header is regenerated, the copied functions 
are registered so that you can use them in your current project. 
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Alternative operation 


904 


Alternatively, you can start a generation process as follows: 


Open the "Options" menu and select "Regenerate Header" or use the corresponding key 
combination. 


Note 


In the event that WinCC is reinstalled or upgraded, the standard functions that were modified 
are deleted or replaced by the unedited standard functions. 


If WinCC is in Runtime, the Runtime system is not influenced by the regeneration of the header. 
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2.13 Creating and Editing Actions 
2.13.1 How To Create and Edit Actions 
Introduction 


There system distinguishes between global and local actions. In a client-server project, global 
actions are carried out on all computers in the project, whereas local ones are carried out only 
on the computer to which they are assigned. 


A global action can, for instance, be used to perform a calculation on all computers in the 
project. 


An example of use for a local action might be to output a log file on a server. 


The process of creating and editing both action types is identical. 


Differences between actions and functions 


e Actions, in contrast to functions, can have a trigger. This means that a function, by itself, 
cannot be executed in Runtime. 


e Actions can be exported and imported. 


e Authorizations can be assigned to actions. This authoriation refers to the operational 
options for the Global Script Runtime troubleshooting window. 


e Anaction has no parameters. 


Finding actions 


New actions can be created, and existing actions can be accessed through the Global Script 
navigation window. 


Actions are stored in the file system as follows: 
=] Project path 
4 «System Name= 


__JPas 
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E)~ 9 Project path 


| Pas 


Editing and Compiling Actions 


An action is edited and compiled in a separate edit window. The edit window displays 
messages from the compiler after a compilation run. These might be warnings or error 
messages. In each case, a Summary of the number of warnings and error messages is output. 


Display of Actions 
ha 


If a syntactically incorrect action is stored, it is displayed in the Global Script navigation window 
with the icon shown to the left. 


la 


If a syntactically correct action is stored with no trigger, it is displayed in the Global Script 
navigation window with the icon shown to the left. 


7) 


If a syntactically correct action is stored with a trigger, it is displayed in the Global Script 
navigation window with the icon shown to the left. 


Please note the following when creating actions: 


The CrossReference feature of WinCC allows for the creation of cross-references. When 
building the cross-reference list, in order that the tags and images be recognized when function 
calls are used as part of actions, the coding rules described further below are to be observed. 


Renaming actions 


Actions are always displayed with their file names in the navigation window. Renaming an 
action means renaming the file containing the action code. 


System behavior if actions are changed, deleted and saved at Runtime 


If a local action is stored at runtime, then all local and global actions of the computer are reset 
on the computer to which the local action belongs. 


If a global action is stored in Runtime, then all local and global actions for the entire project — 
and thus on all computers — are reset. 
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Such a reset might reinitialize for examples tags and times that are used as triggers for actions, 
triggering the action at that stage. 


Static tags used in the reset actions are reinitialized. 


Possible causes for an action not being performed in Runtime 


See also 


Failure of an action to be executed in Runtime might have the following causes: 
e The action has no trigger 
e The action was not compiled 


e Global Script Runtime is not enabled in the project start list 


Note 


Before creating an action, check whether the relevant functionality can also be implemented 
on the automation device. 
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2.13.2 WinCC Coding Rule 


Coding Rules for the Use of CrossReference 


The CrossReference feature of WinCC allows for the creation of cross-references. To ensure 
that the software can recognize the tags and pictures used in function calls made within actions, 


the coding rules given here must be observed. 


The action's code begins with two sections. In the first section, you must declare all tags used; 


in the second section all picture names used. 


Do not enter any other instructions in the sections. 


Both sections are already present in the form of comments when an action is created: 


// 
// 
// 
// 


WINCC: TAGNAME 


n 


ECTION START 


syntax: #define TagNameInAction 


next TagID : 1 


WINCC: TAGNAME 


n 


eal 
Zz 
oO 


ECTION | 


// 
// 
// 
// 


WINCC: PICNAME 


n 


ECTION START 


syntax: #define PicNameInAction 


next PicID : 1 


WINCC: PICNAME 


n 


ECTION | 


ial 
Zz 
oO 


"DMTagName" 


"PictureName" 


The sections are expanded, for example as follows: 


n 


// WINCC:TAGNAME SECTION START 


// syntax: #define TagNameInAction 
// next TagID : 1 


#define ApcTagNamel "TagNamel" 


// WINCC:TAGNAME SECTION END 


// WINCC: PICNAME 


n 


ECTION START 


// syntax: #define PicNameInAction 


// next PicID : 1 


#define ApcPicNamel "PicNamel" 
#define ApcPicName2 "PicName2" 
#define ApcPicName3 "PicName3" 


// WINCC: PICNAM 


r. 


_ SECTION _END 
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"DMTagName" 


"PictureName" 
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Calls to functions to read and write tags and the utilization of picture names must then be 
handled using the defined names: 


GetTagDWord (ApcTagNamel1) ; 
OpenPicture (ApcPicNamel1) ; 


SetPictureName (ApcPicName2, "PictureWindow1l",ApcPicName3) ; 


2.13.3 How to Create a New Action 


Introduction 


In a client-server project, global actions are carried out on all computers in the project, whereas 
local ones are carried out only on the computer to which they are assigned. 


The procedure is identical for both global and local actions. By specifying, in the navigation 
window, the location in which the action is saved, you specify its type (global or local). 


Global Script suggests a default name for the new action. 


A newly created action already contains the instruction #include "apdefap.h". Therefore, all 
functions are registered within the action. The name of the action is found in the third line. The 
first three lines cannot be deleted nor modified. This means that every function can be called 
from each action without requiring any special measures. Furthermore every action has a 
returned value of type "int" and it is already set to a value of 0. 


A returned value of an action can be used in conjunction with GSC Runtime for diagnostic 
purposes. 


The action code begins with a code framework in the form of comments. If this coding 
framework is filled out in accordance with the coding rules, the tags and picture names are 
recognized by CrossReference. 


Procedure 
1. In the navigation window, open the shortcut menu for the desired action type. 


2. Select "New". 


Alternative operation 


Alternatively, you can also create a new action by clicking the associated button in the toolbar, 
via the "File" menu or by using the corresponding key combination. 


See also 
GSC Runtime (Page 928) 
WinCC Coding Rule (Page 908) 
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2.13.4 


Introduction 


Procedure 


How to Edit Actions 


An action is edited in its own edit window exactly like a function. Only the first three lines cannot 
be edited. 


The action must have a return value. The returned value is of the type "int" and is preset to 0. 
A returned value of an action can be modified and used in conjunction with GSC Runtime for 
diagnostic purposes. The returned value's type cannot be changed. 


To execute an action in Runtime, the action must have a trigger. 


1. Double-click the action in the navigation window to open it in an edit window. 
2. Edit the action code. 


Alternative operation 


See also 


2.13.5 


Introduction 


910 


You can also open an action as follows: 


In the navigation window, open the shortcut menu for the desired action and click "Open" or 
"File\Open...". You can also click the ~ button in the standard toolbar or use the corresponding 
key combination. 


Note 


A maximum of 32 Kbytes of memory is available for local tags (tags defined within the braces 
of the action code). 


GSC Runtime (Page 928) 
How to Write Function Code (Page 896) 


How to add action-related information 


Additional information can be assigned to every action. 


When a new action is created, the creation date is entered in the action-related information 
automatically and is unchangeable. The action is also assigned version number 1.0. The 
version numbers can be individually assigned when editing an action. When an action is 
changed and saved, the current date of change is entered automatically and is unchangeable. 
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This dialog can be used to assign a password to protect the action against unauthorized read 
and write access. 


Requirements 


The action to which the information relates must be open in an edit window. 


Procedure 
1. Click the © button in the editing toolbar. The "Properties" dialog is opened. 
2. Select the required entries. 
Properties 


Info| Trigger 


Created By: 


Creation Date: (23 | [2 1996 | 
Changed By: 


Date of change: (31 | 3 | (2008 | 


Version: 


Comment : 


3. Confirm your entries with "OK". 


Alternative operation 
Alternatively, the "Properties" dialog can be opened as follows: 


Click the "Edit" menu and select the "Info" option or use the corresponding key combination. 


See also 
How to Protect an Action Against Unauthorized Access (Page 912) 
How to Set Different Views (Page 885) 
Working with the Toolbars (Page 882) 
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2.13.6 


Introduction 


Requirements 


Procedure 


How to Protect an Action Against Unauthorized Access 


Actions can be protected with a password against unauthorized read and write access. The 
password is a part of the action-related information. 


The action to be compiled must be opened in the edit window. 


1. Click the (4 button in the editing toolbar. The "Properties" dialog is opened. 
2. Select the "Password" check box. 
3. Click the "Change" button. 


Password Entry 


Enter a password (max. 10 characters) to prevent 
modification and viewing. 


Password ; 


Confirmation 


4. Enter the password in the "Password" field. 

5. Enter the password again in the "Confirmation" field. 
6. Confirm your entries with "OK". 

7. Click "OK" to close the dialog. 


Alternative operation 


912 


Alternatively, the "Properties" dialog can be opened as follows: 


Click the "Edit" menu and select the "Info" option or use the corresponding key combination. 


Note 


A password-protected action can only be opened in the edit window if the correct password is 
entered. 


To deactivate the password protection, clear the "Password" check box. 
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See also 
How to Set Different Views (Page 885) 
Working with the Toolbars (Page 882) 
2.13.7 How to Compile and Save an Action 
Introduction 


In order to use an action, it must first be compiled. Only the action in the active edit window is 
compiled. 


Errors reported by the compiler are displayed in the lower portion of the window. Each message 
is displayed on a separate line. The line includes the line number in the source code where 
the error occurred, a hexadecimal encoded error code and a description of the error. 


Double-click such a line to view the source code line where the error occurred. 


It is recommended that you examine the first message error listed, because subsequent ones 
could be errors resulting from the first one. If the first error is corrected, then the others might 
disappear after the next compilation. 


Requirement 


The action to be compiled must be opened in the edit window. 


Procedure 
. Set the language for C compilation using the toolbar. 
. Click 333 on the "Edit" toolbar. 


. Examine the compiler messages in the lower portion of the edit window. 


RW DN = 


. lf the compiler reported an error, the action source code must be corrected. After this has 
been done, start again with step 1 in this table. 


5. If the compiler generated warnings, the action source code may require correction. After 
the code has been corrected, start again with step 1 in this table, otherwise proceed to step 
6. 


6. Click |) on the "Default" toolbar. 


Alternative operation 
Alternatively, the compilation process can be initiated in the following ways: 


Select "Compile" from the "Edit" menu, select the "Compile" option from the shortcut menu of 
the edit window or use the corresponding keyboard shortcut. 


Saving may also be performed in the following ways: 


Select "Save" from the "File" menu or use the corresponding key combination. 
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Display of Actions 


See also 


2.13.8 


2.13.8.1 


hs 
If a syntactically incorrect action is stored, it is displayed in the Global Script navigation window 
with the icon shown to the left. 


la 


If a syntactically correct action is stored with no trigger, it is displayed in the Global Script 
navigation window with the icon shown to the left. 


7) 


If a syntactically correct action is stored with a trigger, it is displayed in the Global Script 
navigation window with the icon shown to the left. 


Runtime Behavior of Actions (Page 927) 


Triggers 


Triggers 


Defining and Using Triggers 


Trigger Types 


914 


Triggers are used to execute actions in Runtime. To do this, a trigger is linked to an action, 
forming the triggering event for calling the action. Actions without triggers are not executed. 


The following trigger types are available: 


Acyclic Triggers 

These consist of a specified date and time. The action specified by such a trigger is performed 
once at the date and time specified. 

Cyclic Triggers 


These consist of a specified time interval and starting point. The following types of cyclic 
triggers are available: 


@ Default cycle. The start of the first time interval coincides with the start of Runtime. The 
length of the interval is determined by the cycle. 


e Hourly. The start of the interval is specified as minutes and seconds. The length of the 
interval is an hour. 
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e@ Daily. The start of the interval is specified by the time (hours, minutes and seconds). The 
length of the interval is a day. 


e Weekly. The start of the interval is specified by the day of the week (Monday, Tuesday, 
etc.) and the time. The length of the interval is a week. 


@ Monthly. The start of the interval is specified by the day and time. The length of the interval 
is a month. 


e Annually. The start of the interval is specified by the day, month and time. The length of 
the interval is a year. 


Tag Triggers 


These consist of the specification of one or more tags. The action associated with such a trigger 
is performed each time a change in the value of one of these tags is detected. 

How the tag values are queried may be customized for each tag. Either cyclic polling with a 
specified period or a reaction as soon as the system detects a change in the tag value may 
be selected. 

Depending on the choice of query method, it is possible that the tag changes but the system 
does not detect this. In this case the action is not performed. 


Effect of Triggers on an Action 


If the action is associated with only one trigger, then the action is performed as soon as the 
triggering event occurs. 


However, an action may be associated with multiple triggers, such as a cyclic trigger and a 
tag trigger. In this case, the action is performed whenever one of the two triggering events 

occurs. If two events occur simultaneously, the action is executed twice in sequence. If two 
tag triggers fire at the same time, the action is performed only once. 


The processing of an action should be completed before another call of the action occurs, as 
there might otherwise be an overflow of the queue. 


Tip:lf the action is not to be carried out with each event occurrence, then a condition can be 
specified for the action that controls its further course dependent on the event. If the action is 
not to be executed any more, it can be terminated with a <value> return. 


Rules for the Selection of Triggers 


Depending on the system, it cannot be guaranteed that an action with a cyclic trigger is carried 
out at exactly the specified time. If this is a requirement, then the task (such as a check, etc.) 
must be implemented on the automation device. 


For processing, tag triggers have priority over cyclic triggers. 


e Foracyclic trigger, the action is always performed when the trigger event occurs, e.g. every 
20 seconds. (# = action is performed) 
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Trigger variable 


Cyclical Trigger 


¢ £ & £ & Time 


e The tag trigger only causes the action to be performed if the value of the trigger tag has 
changed. This is done to reduce the system load (¥ = action is performed). 


Trigger variable Variable Trigger 


F F F Time 


The values of tags contained in the trigger are already known when the action begins. The 
GetTag() call can be used to access the value directly. Processing is much faster than for 

trigger tags than for those not contained in the trigger whose values must be obtained via 

GetTag() requests. 


Display of Actions 


See also 


916 


If a syntactically incorrect action is stored, it is displayed in the Global Script navigation window 
with the icon shown to the left. 


la 


If a syntactically correct action is stored with no trigger, it is displayed in the Global Script 
navigation window with the icon shown to the left. 


a 


If a syntactically correct action is stored with a trigger, it is displayed in the Global Script 
navigation window with the icon shown to the left. 


How to delete a trigger (Page 921) 

How to change a trigger (Page 920) 

How to Add a New Trigger of the "Tag" Type (Page 918) 
How to Add a New Trigger of the "Timer" Type (Page 917) 
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2.13.8.2 How to Add a New Trigger of the "Timer" Type 


Introduction 


Triggers are used to execute actions in Runtime. To do t his, a trigger is linked to an action, 
forming the triggering event for calling the action. Actions without triggers are not executed. 


"Timer" type triggers can be cyclic or acyclic triggers. 


Acyclic triggers consist of a specified date and time. The action specified by such a trigger is 
performed once at the date and time specified. 


Cyclic triggers consist of a specified time interval and starting point. The following types of 
cyclic triggers are available: 


Requirement 


Default cycle. The start of the first time interval coincides with the start of the Runtime 
system. The length of the interval is determined by the cycle. 


Hourly. The start of the interval is specified as minutes and seconds. The length of the 
interval is an hour. 


Daily. The start of the interval is specified by the time (hours, minutes and seconds). The 
length of the interval is a day. 


Weekly. The start of the interval is specified by the day of the week (Monday, Tuesday, 
Add trigger MEEK 


‘Trigger the day and time. The length of the interval 


Event: y the day, month and time. The length of 
INgIE q 


Standard cycle 
Trigger name Hourly 


The in the active edit window. 


Procedure 


5. 
6. 
7. 


ON = 


Hour: Minute: Second: roperties" dialog is opened. 


'Add" button. 


) |ct a cycle to add a cyclical trigger. 


Complete the required details in the dialog. 
Confirm the entries by clicking "OK". 
Close the "Properties" dialog by clicking "OK". 


Alternative operation 


Alternatively, the "Properties" dialog can be opened as follows: 
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In the "Edit" menu, select "Info", select "Info / Trigger" in the shortcut menu of the edit window, 
or use the corresponding key combination. 


2.13.8.3 How to Add a New Trigger of the "Tag" Type 


Introduction 


Triggers are used to execute actions in Runtime. To do this, a trigger is linked to an action, 
forming the triggering event for calling the action. Actions without triggers are not executed. 


Tag triggers consist of one or more specified tags. The action associated with such a trigger 
is performed each time a change in the value of one of these tags is detected. 

How the tag values are queried may be customized for each tag. Either cyclic polling with a 
specified period or a reaction as soon as the system detects a change in the tag value may 
be selected. 


Depending on the choice of query method, it is possible that the tag changes while the system 
fails to detect this. In this case the action is not performed. 


Requirements 


The action to be linked with a trigger must be open in the active edit window. 


Procedure 
1. Click the J button in the editing toolbar. The "Properties" dialog is opened. 
2. Select the "Trigger" tab. 
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3. Select the trigger source "Tag" and click the "Add" button. The "Add Tags" dialog is opened. 


Add trigger HEI 


Trigger 


Event: Tag iad 


Tag name SY | 


Cancel | Apply Help | 


4. Click the _...| button to open the tag selection dialog, select a tag and confirm your selection 
by clicking "OK". 


5. Inthe "Add Trigger" dialog, open the shortcut menu in the "Standard cycle" column and 
then select the desired monitoring cycle. Selecting "After Every Change" results continuous 
monitoring. 


6. Repeat steps 4 and 5, if you want add more tags. 
7. Confirm the entries by clicking "OK". 
8. Close the "Properties" dialog by clicking "OK". 


Alternative operation 
Alternatively, the "Properties" dialog can be opened as follows: 


In the "Edit" menu, select "Info", select "Info / Trigger" in the shortcut menu of the edit window, 
or use the corresponding key combination. 


In the "Add Trigger" dialog, you can also enter a tag name directly and insert the tag in the 
"Trigger Name" column by clicking "Add". With this approach, the system does however not 
check whether the tag exists. 
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2.13.8.4 How to change a trigger 


Introduction 


Triggers that have been defined can be changed at any time. They can also be changed in 
Runtime. 


Requirements 


The relevant action must be opened in the edit window. 


Procedure 
1. Click the ‘4 button in the editing toolbar. The "Properties" dialog is opened. 


2. Select the "Trigger" tab and select the trigger you wish to change. 


Properties 
[info | Trigger | ane, 
cs Timer 
: é ‘eas 
Es 25) | Delete 
Change ] 


Click the "Change" button to open the "Change Trigger" dialog. 
Make the desired changes. 


Confirm the entries by clicking "OK". 


on Fw 


Close the "Properties" dialog by clicking "OK". 


Alternative operation 
Alternatively, the "Properties" dialog can be opened as follows: 


In the "Edit" menu, select "Info", select "Info / Trigger" in the shortcut menu of the edit window, 
or use the corresponding key combination. 
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2.13.8.5 How to delete a trigger 


Introduction 


Triggers that have been defined can be deleted at any time. They can also be deleted in 
Runtime. 


If a trigger is deleted in Runtime, it only takes effect after the action is saved. 


Requirements 
The relevant action must be opened in the edit window. 


Procedure 
1. Click the (4 button in the editing toolbar. The "Properties" dialog is opened. 


2. Select the "Trigger" tab and select the trigger you wish to delete. 


Properties 
[info | Trigger | 
$ Timer 
: é net 
Es 25) Delete 
|_Change _| 


3. Delete the selected trigger by clicking "Delete". 
4. Close the "Properties" dialog by clicking "OK". 


Alternative operation 
Alternatively, the "Properties" dialog can be opened as follows: 


In the "Edit" menu, select "Info", select "Info / Trigger" in the shortcut menu of the edit window, 
or use the corresponding key combination. 
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2.13.9 How to Assign Authorizations 


Introduction 


With the Global Script - Runtime diagnostic tool, you can influence the processing of actions 
in Runtime. Each action can be assigned an authorization. This authorization only effects the 
operation in the Global Script - Runtime window. 


Requirement 
The relevant action must be opened in the editing window. 


Procedure 


1. Click #2 in the toolbar. 
The "Authorizations" dialog box is opened. 


2. Select an authorization. 


Authorizations 


(us 
OK 
<No access protection > “ Cancel 


User Administration 

Value input 

Process controlling 

Picture Editing 

Change picture 

Window selection — 
Hardcopy 

Confirm alarms 

Lock alarms 

Free alarms 

Message Editing 

Start archive 

Stop archive 

Edit archive values 

Archive Editing v 


a 


3. Confirm your selection with "OK". 


See also 
GSC Runtime (Page 928) 


2.13.10 How to Export an Action 


Introduction 


Use export and import to move actions between projects. The triggers linked to the actions 
are retained in the process. 
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Requirements 


The action to be exported must be opened in the edit window. 


Procedure 


1. Click the _} button in the editing toolbar. The "Save As" dialog is opened. 


2. Select the path and file name for the action that you wish to export. 


& Save As x ' 
ee ¥ | « WinCC_Project_yorro » PAS 7 | +4 | Search PAS 5°) 
Organize ¥ New folder {== w @ 

$e Favorites Name Date modified Type Size 
MB Desktop _) gscesl.act 11/12/2012 2:32PM ACT File 1KB| 
g Downloads 


=| Recent Places 
(ow Libraries 
? Computer 


Gu Network 


Filename: gsccsl.act 


Save as type: | act Files (*.act) 7 


* Hide Folders Cancel 


3. Close the dialog by clicking the "Save" button. 


Alternative operation 
Alternatively, you can start the export as follows: 


In the "Edit" menu, select "Export", select "Export" in the shortcut menu of the edit window, or 
use the corresponding key combination. 


2.13.11 How to Import an Action 


Introduction 


Use export and import to move actions between projects. The triggers linked to the actions 
are retained in the process. 
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The action in the active edit window is replaced by the imported action. 


Procedure 
1. Click the +) button in the editing toolbar. The "Open" dialog is opened. 
2. Select the path and file name of the action that you wish to import. 

i Open xs) 
COW |) « WIN-APHMO79VMJE » WinCC Project yorro » PAS + | #4] [ Search PAS P| 
Organize v New folder =»  @ 

ir Eavodies Name > Date modified Type Size 
BB Desktop L_} gscesl.act 11/12/2012 2:34 PM ACT File 1KB 
R Downloads 
=| Recent Places 
(ea Libraries 
1™ Computer 
Gu Network 
File name: ¥ Actions (*.act) | 
=e 


3. Close the dialog by clicking the "Open" button. 


Alternative operation 
Alternatively, you can start the import as follows: 


In the "Edit" menu, select "Import", select "Import" in the shortcut menu of the edit window, or 
use the corresponding key combination. 


2.13.12 How to Rename an Action 


Introduction 


You may rename an action at any time. The action is thereby assigned a different file name. 
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Requirements 


The action to be renamed may not be open in the edit window. 


Procedure 


1. Open the shortcut menu of the action to be renamed. 
2. Select "Rename". 


3. Enter a new name with the file extension ".pas". 
Global Script wx 
32] Project functions 
$=] Standard functions 
$=: Internal functions 
=|--¥53] Actions 
=|} Actions : WIN-APHMO79VMIJE 
{x} gsccsl.pas 


‘= )] TankLevel.pas 


32] Global actions 


"y 


+ 


4. Confirm the new name by pressing the <ENTER> key. 


Alternative operation 


Alternatively, click the action name twice to complete the renaming. 


Note 


If you do not enter the file extension ".pas", the action name remains unchanged. 


2.13.13 How to Use Actions From Other Sources 


Introduction 


You have two options for using actions from other sources in your project: 
@ Importing exported actions 


® Copy the file with the desired action into the corresponding path in your project. The path 


for local actions is "<Computer_name>\Pas" in the project path. The path for global actions 
is "\Pas" in the project path. 


To show the copied actions in the navigation window, you must refresh the display. This can 
be accomplished by quitting and then restarting Global Script. 
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If Runtime is active, imported actions are only executed, after they have been opened in Global 
Script Editor and then saved. 


Note 


Actions can include calls to project and standard functions. These can in turn have calls to 
project and standard functions etc. Therefore, when importing actions from other sources, you 
must make sure that the current project has all necessary functions. 


Particular attention is called for whenever the actions were imported from a different computer. 
Since standard functions can be customized by the user, it is possible that the standard 
functions called in the action have a different functionality on the source computer than the 
ones with the same names on the target computer. 


See also 
How to Import an Action (Page 923) 
How to Export an Action (Page 922) 
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2.14 Runtime Behavior of Actions 


2.14.1 Runtime Behavior of Actions 


Analysis of Runtime Behavior 


WinCC provides a range of tools with which the Runtime behavior of actions can be analyzed. 
These are the application windows GSC Runtime and GSC Diagnose plus the application 
apdiag.exe. 


To use the application windows GSC Runtime and GSC Diagnose, they must be added to a 
process picture. This may be a process picture made especially for diagnostic purposes. This 
picture is then called in Runtime. 


The application windows are used for the following strategies: 


e GSC Runtime supplies information about the dynamic behavior of all (Global Script) actions, 
supports the individual start and the Start and End Action for each individual action and 
provides an entry point into Global Script Editor, while Runtime is active. 


e GSC Diagnose outputs the printf instructions (contained in the actions) in the order in which 
they are called. This also applies to the printf instructions in functions that are called in 
actions. Through a well thought out use of printf instructions, for example to output the 
values of tags, it is possible to follow the action's flow and that of the called functions. Even 
error conditions, which result in a call to the OnErrorExecute function, are displayed in the 
GSC Diagnose window. 


Note 


When using dynamic C-scripts with access to picture objects, you should note that 
execution of the script is not terminated automatically by closing the picture. 


This scenario may to the failure of access to an object that is addressed in the script, e.g. 
if properties of the type "Text" are read and the values returned are modified or processed 
in subsequent string operations. 


See also 
GSC Diagnose (Page 933) 
GSC Runtime (Page 928) 
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2.14.2 GSC Runtime 


2.14.2.1 GSC Runtime 


GSC Runtime Window 


GSC Runtime is a window showing the dynamic behavior of all (Global Script) actions in 
Runtime. Additionally, GSC Runtime, enables you to influence the execution of each individual 
action and provides an entry point into Global Script Editor, while Runtime is active. 


The following information is output: 
e Action: Name of the action 


e |D: Action ID. It is used internally to the system and for example is output by the function 
OnErrorExecute together with a description of the error in the event that an error occurs in 
the action. GSC Runtime supplies the name of the action with this ID. The connection 
between the ID and action name ceases to be valid when Runtime is terminated or an action 
is saved while Runtime is active. 


e Status: Current status of the action. For possible statuses, refer to the table below. 


e Activation Interval: The time in the form hours:minutes:seconds that has elapsed between 
two calls to the action. 


e Return Value: Return value of the action. 
e Started On: Date and time at which the current action was started. 
e Next Start: Date and time at which the action is started again. 


e Error Message: Contains the error text in the case of an error. 


fil Global Script - Run Time 


Action ID Status Actvation Interval | Return Value | Stated on: Next Start Error message: 
TankLevelpas @15 Action is running 00:2 10 09/27/00 17:36:16 
qsccs] 2pas  @16 Action was ended 0: 0:2 i 09/27/00 17:35:50 
gsccs1_l.pas @17 Action was started. 0 09/27/00 17:35:31 = 11/27/0017:35:08 
gsccs1.pas @18 Action is running 00:2 0 09/27/00 17:36:16 


Statuses of actions 


Possible statuses of actions: 
e Action was started. 

e Action was ended. 

e Action was stopped. 


e Action is running. 
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Error during start of action! 


Error during execution of action! 


Possible error messages: 


No error occurred. 


The application is already connected to the script control. No additional connection setup 
is possible. 


There is no connection to the script control. Possibly no connection setup took place. 
An error occurred during interprocess communication. The cause of the error is unknown. 
Undefined error. 

The parameter assignment is wrong. Some necessary parameters may be missing. 
Script control is not started. Check has whether WinCC has been started. 

Time-out occurred. Check the connection or increase the monitoring time. 

Script control was terminated. 

The service channel could not be installed. 

An unknown job number was used for the EndAct job. 

The action could not be executed without error. The returned results are invalid. 

An error occurred in the server application. 

The maximum number of connections to the script control has been reached. 


The transaction is unknown. An attempt was made to terminate a transaction that was not 
logged on previously. 


A pre-compiled header file cannot be generated from a pre-compiled header file. 
There is no access to the action. The module is being used presently. 

The program is invalid. 

The action is invalid. 

The script control could not set up the file. 

The script interpreter does not have enough memory. 

The file format is invalid for the script control. 

The script control could not open the file. 

The program is presently locked by the script control. No further access is possible. 
The action has already been given to the script control for processing. 

In this action, a conflict has occurred with another action. 

The script control could not find the action. 

The script control could not find the function. 


The specified line information is invalid. 
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e@ The specified symbol is outside the valid range. 

@ The provided memory is too small for the script interpreter. 
e The script interpreter does not recognize the specified type. 
e The specified symbol was not found. 

e Load project functions. 


e A stack overflow has occurred in the script interpreter during execution. Further execution 
of the action is being canceled. 


e Division by 0 occurred during execution of an action. The action is being canceled. 
e Within the action, a reference was made during execution to a symbol that does not exist. 


e Within the action, an attempt was made during execution to access an undefined memory 
area. 


e The script interpreter ran into a breakpoint. 

e The script interpreter was advanced in the debugger by one processing step. 

e The action contains no interpreter code. 

e The action has the wrong data format. 

e The return value of the action cannot be represented as a variant. 

e There is insufficient memory to execute this operation. 

e Anerror has occurred within the transaction. For more information, see the AP_ACT_KEYs. 
e Anerror occurred while executing the action. For more information, see the AP_ACT_KEYs. 
e Anerror occurred while executing the action. For more information, see the AP_ACT_KEYs. 


e@ There is no update capability for the existing data format. The action cannot be read. 


Shortcut Menu for Actions 
The following functions are available for every action in the shortcut menu: 


e@ End Action: The corresponding action is not executed again after the current execution is 
completed. 


e@ Start Action: The corresponding action is executed again when the next trigger occurs. 
e Start: The relevant action is executed once. 


e Edit: The relevant action is opened in the Global Script editor for editing. Runtime remains 
active. If the edited action is compiled (if necessary) and saved, the changes are 
immediately adopted by the Runtime system. 


End Action 


Start A chct 


Start 


Edit 
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You can determine for each action individually, whether or not the popup menu can be opened 
without a password. 


To use GSC Runtime, you must first add an application window of the GSC Runtime type in 
a process picture. Using the GSC Runtime attributes, you can determine the appearance of 
the GSC Runtime window. 


Note 


Updating the GSC Runtime window increases the load on the system resources. The system 
load depends on how many actions are visible in the window. The system load can be lowered 
by reducing the height of the window so that fewer lines are visible. 


See also 
How to Edit Actions (Page 932) 
Attributes of GSC Runtime (Page 932) 
How to Place GSC Runtime in a Process Picture (Page 931) 
How to Assign Authorizations (Page 922) 
2.14.2.2 How to Place GSC Runtime in a Process Picture 
Introduction 


To use GSC Runtime, you must add GSC Runtime to a process picture. This process picture 
can be an existing picture or a picture that just serves diagnostic purposes. GSC Runtime 
cannot be added to the process picture directly, rather it must be added as an application in 
an application window. The application window is itself part of the process picture. The 
measures described must be performed in Graphics Designer. 


Requirement 


Graphics Designer has been started and the process picture is open. 


Procedure 

. Inthe Object palette, select "Smart Object\Application Window". 
. Inthe drawing area, open the application window. 

. Inthe "Window Contents" dialog select "Global Script". 

. Confirm the entries by clicking "OK". 


. Inthe "Template" dialog, select "GSC Runtime". 


Oona FF WwW ND = 


. Click "OK" to confirm your selection. 
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See also 


2.14.2.3 


Attributes of GSC Runtime (Page 932) 


Attributes of GSC Runtime 


GSC Runtime Window Layout 


GSC Runtime has attributes with which you can determine the appearance of the GSC Runtime 
window in Runtime. These include the geometry attribute and in particular the following 
attributes: 


2.14.2.4 


Introduction 


Procedure 


See also 


932 


Display: With this attribute, you can specify whether the window should be visible or hidden. 
The attribute can be made dynamic with the name "Visible". 


Sizeable: Use this attribute to specify whether the window size can be changed in Runtime. 
Moveable: Use this attribute to specify whether the window can be moved in Runtime. 


Border: Use this attribute to specify whether the window has a border. If the window has a 
border, its height and width can be changed in Runtime. 


Title: Use this attribute to specify whether the window has a title bar. 


Can be Maximized: Use this attribute to specify whether the window's title bar has a button 
to maximize the window in Runtime. 


Can be Closed: Use this attribute to specify whether the window's title bar has a button to 
close the window in Runtime. 


Foreground: Use this attribute to specify whether the window is always in the foreground. 


The attributes are displayed and can be set in Graphics Designer. 


How to Edit Actions 


Each of the actions in your project will be displayed on its own line in the GSC Runtime window. 
You can open an action in the GSC Runtime window and then edit it using Global Script Editor. 
After the edited action is saved, it is used in Runtime. 


1. 
2. 


Open the shortcut menu for the desired action. 
Select "Edit". 


How To Create and Edit Actions (Page 905) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


ANSI-C for Creating Functions and Actions 


2.14 Runtime Behavior of Actions 


2.14.3 GSC Diagnose 


2.14.3.1 GSC Diagnose 


Description of Functions 


GSC Diagnose outputs the printf instructions (contained in the actions) in the order in which 

they are called in the Diagnose window. This also applies to the printf instructions in functions 
that are called in actions. Through a well thought out use of printf instructions, for example to 
output the values of tags, it is possible to follow the action's flow and that of the called functions. 
Even error conditions, which result in a call to the OnErrorExecute function, are displayed in 

the GSC Diagnose window. 


Global Script - Diagnostics : = 


(Threadld 960) 2006-02-21 09:18:02.981 
(Threadid 960) 1007007 

(Threadid 960) 2 

(Threadld 960) PDLRTAPI oder DMAP!| 
(Threadid 960) Error in DMApi 
(Threadld 960) 

(Threadld 960) 

(Threadlid 960) 

(Threadid 960) 

(Threadld 960) 


21.02.06 (10:20:51 Wi, 


Image 2-1 Diagnose window of GSC Diagnose 


To use GSC Diagnose, you must first add an application window of the GSC Diagnose type 
in a process picture. Using the GSC Diagnose attributes, you can determine the appearance 
of the GSC Diagnose window. 


When the picture is changed, the contents in the GSC Diagnose window is deleted. 


Note 


A printf() may contain maximum 360 characters. 
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See also 

The Toolbar of GSC Diagnose (Page 935) 

Attributes of GSC Runtime (Page 932) 

How to Place GSC Diagnose in a Process Picture? (Page 934) 
2.14.3.2 How to Place GSC Diagnose in a Process Picture? 
Introduction 


To use GSC Diagnose, you must add GSC Diagnose to a process picture. This process picture 
can be an existing picture or a picture that just serves diagnostic purposes. GSC Diagnose 
cannot be added as an application to the process picture directly, rather it must be added as 
an application in an application window. The application window is itself part of the process 
picture. The measures described must be performed in Graphics Designer. 


Requirement 


Graphics Designer has been started and the process picture is open. 


Procedure 

In the Object palette, select "Smart Object\Application Window". 
In the drawing area, open the application window. 

In the "Window Contents" dialog select "Global Script". 

Confirm the entries by clicking "OK". 


In the "Template" dialog, select "GSC Diagnose". 


OF. (OF Ps SINE 


Click "OK" to confirm your selection. 


See also 
Attributes of GSC Runtime (Page 932) 
The Toolbar of GSC Diagnose (Page 935) 
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2.14.3.3 Attributes of GSC Diagnose 


GSC Diagnose Attributes 


GSC Diagnose has attributes with which you can determine the appearance of the GSC 
Diagnose window in Runtime. These include the geometry attribute and in particular the 
following attributes: 


e Display: With this attribute, you can specify whether the window should be visible or hidden. 
The attribute can be made dynamic with the name "Visible". 


e@ Sizeable: Use this attribute to specify whether the window size can be changed in Runtime. 
@ Moveable: Use this attribute to specify whether the window can be moved in Runtime. 


e Border: Use this attribute to specify whether the window has a border. If the window has a 
border, its height and width can be changed in Runtime. 


e Title: Use this attribute to specify whether the window has a title bar. 


e Can be Maximized: Use this attribute to specify whether the window's title bar has a button 
to maximize the window in Runtime. 


@ Can be Closed: Use this attribute to specify whether the window's title bar has a button to 
close the window in Runtime. 


e Foreground: Use this attribute to specify whether the window is always in the foreground. 


The attributes are displayed and can be set in Graphics Designer. 
2.14.3.4 The Toolbar of GSC Diagnose 


Toolbar Functions 


The toolbar of GSC Diagnose includes buttons for the control the output in the Diagnose 
window as well as for saving, printing and opening the contents of the window. 


X/ 212 | fe | | 


The toolbar contains buttons with the following functions: 


Button Function 


Deletes the contents of the window. 


Stops the updating of the window. 


Resumes the updating of the window. 


Opens a text file in the window. 


Saves the contents of the window in a text file. 


ML | |W | P53 | JS | | 


DPrints the contents of the window. 
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2.15 ANSI-C function descriptions 
2.15.1 lpszPictureName 
Overview 


"IpszPictureName" is the name of the picture. 


If you configure an action on a property or a "Mouse-click" event in WinCC, the name of the 
picture is provided as "IpszPictureName" in the action. The picture name has the following 
structure: 


<BASE PICTURE NAME>.<PICTURE WINDOW NAME>:<PICTURE NAME>. ... .<Picture 
window name>:<Picture name>. 


The "BASE PICTURE NAME" and the "PICTURE NAME" are provided without the file 
extension ".PDL". 


This enables you to identify the object's picture path. You can also address specific picture 
windows, if a process picture is opened more than once for example. 


Note 


Do not change the text in "IpszPictureName not even using the function "strcat". 


2.15.2 Standard functions 


2.15.2.1 Standard functions - short description 


The system provides standard functions. You can modify these functions to adapt them to your 
personal needs. Furthermore, you can create your own standard functions. 


The basic system provides you with standard functions. They are divided into the following 
function groups: 


e Alarm 

@ Graphics 
@ Report 
e TagLog 
e@ WinCC 
e Windows 


The "Obsolete functions" directory contains standard functions that were used to control the 
control before WinCC V7. 
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If the corresponding options have been installed, the following additional function groups are 
available: 


e Options 
@ Split Screen Manager 


e userarc (user archives) 


2.15.2.2 Alarm 


AcknowledgeMessage 


Function 


Acknowledges the message with the number that has been sent as a parameter in the message 
system. 


Syntax 
void AcknowledgeMessage(DWORD MsgNr) 
Parameters 
MsgNo 
Message to be acknowledged 
Note 
Make sure a configured message exists for the transferred message number. 
To use the function on a client with its own project, a standard server for alarms has to be 
configured on the client. 
GCreateMyOperationMsg 
Function 


The "GCreateMyOperationMsg" standard function makes it possible to trigger your own 
operator input message in the message system. The message with the "dwMsgNum" message 
number must have already been configured as the operator input message. 
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Syntax 
int GCreateMyOperationMsg( DWORD dwFlags, DWORD dwMsgNun, char* 
lpszPictureName, char* lpszObjectName, DWORD dwMyTextID, double doValueOld, double 
doValueNew, char* pszComment) 

Parameters 


dwFlags 
The message form can be selected using the "dwFlags" parameter. 


Name Value Description 


FLAG_COMMENT_PARAMETER 0x00000001 The text is entered as a comment directly into 
the message in Runtime, without its own com- 
ment dialog. The pointer to the comment must 
not equal "NULL." 


FLAG_COMMENT_DIALOG 0x00000003 | Acomment dialog appears. The comment en- 
tered there is transferred to the message. 
FLAG_TEXTID_PARAMETER 0x00000100 ‘| The text ID of a text from the TextLibrary is 


provided as the accompanying process value 
of the message. 


dwMsgNum 
WinCC message number of a self-created operator input message. 


IpszPictureName 
Pointer to the picture name of the picture from which the function is called. 


IpszObjectName 
Pointer to the WinCC tag name to which the old values and new values belong. 


The name is forwarded as the instance name of the operator input message and entered in 
the accompanying process value "1". 


dwMyTextID 
Text ID of a text from the TextLibrary. 


When the "FLAG_TEXTID_PARAMETER' is set, the text ID is provided as the numeric 
accompanying process value "8" of the message and is displayed as a number in process 
value block 8. So that the language-dependent text from the TextLibrary is displayed in the 
message, you must enter format statement "@8%s@" in the message text block. 


doValueOld 


Numeric old value of the WinCC tags with the name specified in "IpszObjectName". 
"doValueOld" is entered in the accompanying process value "2" of the message. 

The function itself has no option of reading a tag value before the action. For this, use the 
provided "GetTag..." feature. 
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Return value 


GMsgFunction 


Function 


Syntax 


940 


doValueNew 


Numeric new value of the WinCC tags with the name specified in "IpszObjectName". 
"doValueNew" is entered in the accompanying proces value "3" of the message. 

The function itself has no option of reading a tag value after the action. For this, use the 
provided "GetTag..." feature. 


pszComment 


Comment text or empty string. 


When "FLAG_COMMENT_PARAMETER" is set, the text is entered directly into the message 
in Runtime as a comment. The message does not need a separate comment dialog. 


Description 
The function has been completed without any errors. 
The message editing could not be started. 


An error occurred when calling the "MSRTGetComment()" 
feature. 


An error occurred when calling the "MSRTCreateMsgInstan- 
ceWithComment()" feature. 


Note 


Make sure that only operator input messages are used for the "GCreateMyOperationMsg" 
function. The use of messages of different message classes is not permitted. 


Please note the role of the standard server when using the function with a Client. For more 
information see the chapter "Client configuration". 


This function provides the message data. 


It is a global function for single messages. It is called for each message for which the "Triggers 
an action" parameter has been set. 


Evaluation of the message data is best made in a project function called from GMsgFunction. 


BOOL GMsgFunction(char* pszMsgData) 
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Parameters 


Return value 


2.15 ANSI-C function descriptions 


pszMsgData 


Pointer to a string whose data are mapped with scanf to the MSG_RTDATA_STRUCT 
structure. 


The "MSG_RTDATA_STRUCT" string contains the following data, which are separated from 
each other with "#": 


1. Telegram time 
2. Process values 
3. Instance 
4. User 
5. Computer 
6. Current time in format "yyyy.mm.dd, hh:mm:ss.mmm" 
Note 
The value "Instance" of string "MSG_RTDATA_STRUCT" is only supplied if an instance 
message was triggered. 
The values "User" and "Computer" of the string "UMSG_RTDATA_STRUCT" are only 
supplied if a comment was provided during the creation of the message with the same call. 
TRUE 


The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


Please note that modified standard functions are overwritten by a WinCC installation so that 
the changes will be lost. 
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2.15.2.3 Graphics 


Graphics - short description 


The Graphics group contains functions for programming the graphic system. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


GetLinkedVariable 


Function 


Syntax 


Parameters 


Return value 


GetLocalPicture 


Function 


942 


Provides the name of the variable linked to a certain object property. 


char* GetLinkedVariable(char* IpszPictureName, char* lpszObjectName, char* 
lpszPropertyName); 


IpszPictureName 
Pointer to the picture 


IpszObjectName 
Pointer to the object 


IpszPropertyName 
Pointer to the object property 


Pointer to the name of the tag linked to a certain object property. 


Provides a pointer to the name of the picture. The picture name is the file name without the 
"PDL" extension. 
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Syntax 


Parameters 


Return value 


Example: 


GetParentPicture 


Function 


Syntax 


2.15 ANSI-C function descriptions 


char* GetLocalPicture(char* IpszPictureName); 


IpszPictureName 
Pointer to the picture 


Pointer on the name of the picture. 


Note 


The passed call parameter lpszPictureName must have the structure provided by the graphics 
system for the picture paths: 


<Basic picture name>.<Picture window name>:<Picture name>. ... .<Picture window 
name>[:<Picture name>] 


where <Basic picture name> and <Picture name> go without the ".PDL" file extension. 


In a basic picture "AAA" there is a picture window "bbb" in which a picture "CCC" is called 
which itself contains a picture window "ddd" in which a picture "EEE" is called. 


Then the function call 

GetLocalPicture (lpszPictureName) 

returns the pointer to the picture name: 

"EEE" if the functions is called in the picture "EEE"; 
"CCC" if the functions is called in the picture "CCC"; 
"AAA" if the functions is called in the picture "AAA". 


Provides a pointer to the name of the picture. The picture name is the file name without the 
".PDL" extension. 


char* GetParentPicture(char* IpszPictureName); 
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Parameters 


Return value 


IpszPictureName 
Pointer to the picture 


Name of the current picture if the function is called in the basic picture 


Name path of the higher-level picture if the function is called in a picture window 


Note 


The passed call parameter lpszPictureName must have the structure provided by the graphics 
system for the picture paths: 


<Basic picture name>.<Picture window name>:<Picture name>. ... .<Picture window 
name>[:<Picture name>] 


where <Basic picture name> and <Picture name> go without the ".PDL" file extension. 


GetParentPictureWindow 


Function 


Syntax 


Parameters 


Return value 


944 


Provides a pointer to the name of the picture window. 


char* GetParentPictureWindow(char* IpszPictureName); 


IpszPictureName 
Pointer to the picture 


Pointer to the name of the picture window if the function is called in a picture displayed in a 
picture window of a higher-level picture 


Call parameter IpszPictureName unchanged if the function is called in the basic picture 
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Example: 


OpenPicture 


Function 


2.15 ANSI-C function descriptions 


Note 


The passed call parameter lpszPictureName must have the structure provided by the graphics 
system for the picture paths: 


<Basic picture name>.<Picture window name>:<Picture name>. ... .<Picture window 
name>[:<Picture name>] 


where <Basic picture name> and <Picture name> go without the ".PDL" file extension. 


In a basic picture "Picture_1" there is a picture window "Picture_window_1" in which a picture 
"Picture_2" is called. 


In the picture "Picture_2" there is a picture window "Picture_window_2" in which a picture 
"Picture_3" is called. 


Then the function call 

GetParentPictureWindow (lpszPictureName) 

returns the pointer to the picture window name: 

"Picture_2" if the function is called in the picture "Picture_3"; 
"Picture_window_1" if the function is called in the picture "Picture_2"; 


"Picture_1" if the function is called in the picture "Picture_1". 


Changes the specified basic picture. On the client and in case of a picture name with server 
prefix a picture change is performed in the picture window. 


If, for example, the picture window is located in a different picture window with a server prefix, 
a picture change is not performed in the picture window in which the function was called. 


If multiple picture windows with server prefix are integrated in the picture and the 
"OpenPicture()" function calls the last picture, the picture change is carried out in the first 
picture window. For example, 

"screen .window1(screen2.window2(screen3.window3(screen4.OpenPicture)))" executes a 
picture change in "window1". 


WinCC Alarm Control: WinCC server or WinCC client with its own project 


If you have selected a server package in the WinCC AlarmControl, the picture change takes 
place in the picture window of the WinCC Alarm Control when called with "Loop in Alarm". 
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Syntax 


Parameters 


Registry2 


Function 


Syntax 


Parameters 


946 


void OpenPicture(Picture PictureName) 


Picture name 


Picture name 


This function manages a list of string pairs (StringO, String1). 

It knows the following types of calls controlled by the mode parameter: 
e Registry2("set", "StringO", "String1"); 

Includes the passed string pair into the list. 

e Registry2("get", "StringO", NULL); 


Returns the first string pair partner String1 which belongs to the passed StringO and then 
deletes the string pair from the list. 


e Registry2("reset", NULL, NULL); 
Deletes all string pairs from the list. 
e Registry2("display", NULL, NULL); 


Shows the string pairs currently stored in the list in a Global Script diagnostics window. 


char* Registry2(char* mode, char* StringO, char* String1); 


mode 
Defines the working principle of the function. 


set Incorporation of the string pair into the list 


get Determination of the first sting pair partner for StringO and deletion of the string 
pair from the list 


reset Deletion of all string pairs 
display Display of the string pairs in a Global Script diagnostics window 


StringO 
The parameter supply depends on the working principle of the function. 
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2.15.2.4 


Alarm 


2.15 ANSI-C function descriptions 


String1 
The parameter supply depends on the working principle of the function. 


In the mode=get mode a pointer to the first string pair partner is returned. 


Note 
This function is used in conjunction with the picture module technology. 


If you work with the "Create faceplate as type" and "Create instance(s) in the process picture" 
wizards in the "Faceplates" tab of the Dynamic Wizard, using the "Registry2" function is not 
permitted! 


Obsolete functions 


AXC_OnBinAlarmHidingList 


Function 


Syntax 


Parameters 


Return value 


This function displays the list of hidden messages in a message window. 


BOOL AXC_OnBtnAlarmHidingList(char* lpszPictureName, char* |pszObjectName) 


IpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 
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FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 


AXC_OnBtnArcLong 


Function 


Syntax 


Parameters 


Return value 


948 


This function displays the messages stored in a long-term archive list in a message window. 


BOOL AXC_OnBtnArcLong (char* IpszPictureName, char* IlpszObjectName) 


IpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 
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AXC_OnBtnArcShort 


Function 

This function displays the messages stored in a short-term archive list in a message window. 
Syntax 

BOOL AXC_OnBtnArcShort(char* lpszPictureName, char* lpszObjectName) 
Parameters 


lpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 


AXC_OnBtnComment 


Function 
External message window operation 


This function displays the comment of the previously selected messages. 


Syntax 
BOOL AXC_OnBtnComment (char* lpszPictureName, char* lpszObjectName) 
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Parameters 


Return value 


IpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 


AXC_OnBtnEmergAckn 


Function 


Syntax 


Parameters 


Return value 
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External message window operation 


This function opens the acknowledgement dialog (emergency acknowledgement/reset). 


BOOL AXC_OnBtnEmergAckn(char* lpszPictureName, char* lpszObjectName) 


IpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 
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FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 


AXC_OnBitnHideDlg 


Function 


Syntax 


Parameters 


Return value 


This function opens the display options dialog for defining the messages that are to be 
displayed in the message window. The options are "All messages", "Shown messages" or 
"Hidden messages". 


BOOL AXC_OnBtnHideDlg(char* IpszPictureName, char* IpszObjectName) 


IpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 
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AXC_OnBtnHideUnhideMsg 


Function 


Syntax 


Parameters 


Return value 


AXC_OnBitnhit 


Function 


Syntax 
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The function hides the selected message or displays again the hidden message. 


BOOL AXC_OnBtnHideUnhideMsg(char* lpszPictureName, char* IpszObjectName) 


lpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 


This function displays the messages stored in the hit list in a message window. 


BOOL AXC_OnBtnHit (char* IpszPictureName, char* IpszObjectName) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


ANSI-C for Creating Functions and Actions 


Parameters 


Return value 
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lpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 


AXC_OnBtnHornAckn 


Function 


Syntax 


Parameters 


Return value 


External message window operation 


This function acknowledges the horn signal. 


BOOL AXC_OnBtnHornAckn (char* IpszPictureName, char* lpszObjectName) 


IpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 
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AXC_OnBtnInfo 


Function 


Syntax 


Parameters 


Return value 
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FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 


External message window operation 


This function displays the information text. 


BOOL AXC_OnBinInfo (char* IpszPictureName, char* IpszObjectName) 


IpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 
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AXC_OnBtnLock 


Function 


Syntax 


Parameters 


Return value 


2.15 ANSI-C function descriptions 


External message window operation 


This function opens the "Set the Lock List Parameters" dialog. 


BOOL AXC_OnBtnLock (char* IpszPictureName, char* IpszObjectName) 


IpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 


AXC_OnBtnLockUnlock 


Function 


Syntax 


This function locks the selected message in the message window. This message will then no 
longer be archived. 


This function unlocks the selected message in the lock list. 


BOOL AXC_OnBtnLockUnlock (char* lpszPictureName, char* lpszObjectName) 
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Parameters 


Return value 


IpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 


AXC_OnBtnLockWin 


Function 


Syntax 


Parameters 


Return value 
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External message window operation. 


This function calls the lock list. 


BOOL AXC_OnBtnLockWin (char* IpszPictureName, char* IlpszObjectName) 


IpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 
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FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 


AXC_OnBtnLoop 


Function 

External message window operation 

This function triggers the "LoopInAlarm" function of the selected message. 
Syntax 

BOOL AXC_OnBtnLoop (char* IpszPictureName, char* IpszObjectName) 
Parameters 


IpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 
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AXC_OnBtnMs¢gFirst 


Function 


Syntax 


Parameters 


Return value 


External message window operation 


This function switches to the beginning of the message list. 


BOOL AXC_OnBtnMs¢First (char* IpszPictureName, char* IlpszObjectName) 


IpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 


AXC_OnBtnMsgLast 


Function 


Syntax 
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External message window operation 


This function switches to the beginning of the message list. 


BOOL AXC_OnBtnMsgLast (char* lpszPictureName, char* lpszObjectName) 
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Parameters 


Return value 
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lpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 


AXC_OnBtnMsgNext 


Function 


Syntax 


Parameters 


Return value 


External message window operation 


This function switches to the next message in the message list. 


BOOL AXC_OnBtnMsgNext (char* IpszPictureName, char* lpszObjectName) 


IpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 959 


ANSI-C for Creating Functions and Actions 


2.15 ANSI-C function descriptions 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 


AXC_OnBtnMsgPrev 


Function 


Syntax 


Parameters 


Return value 
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External message window operation 


This function switches to the previous message in the message list. 


BOOL AXC_OnBtnMsgPrev (char* IpszPictureName, char* lpszObjectName) 


IpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 
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AXC_OnBtnMsgWin 


Function 


Syntax 


Parameters 


Return value 


AXC_OnBinPrint 


Function 


External message window operation 


This function calls the message list. 


Note 


The message list contains the currently pending and unacknowledged messages. 


BOOL AXC_OnBtnMsgWin (char* lpszPictureName, char* lpszObjectName) 


IpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 


External message window operation 


All messages fulfilling the selection criterion set in the Alarm Control are output to the printer. 
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Syntax 


Parameters 


Return value 


BOOL AXC_OnBtnPrint(char* |pszPictureName, char* IlpszObjectName) 


IpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 


AXC_OnBtnProtocol 


Function 


Syntax 


Parameters 
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External message window operation 


Printing of the current view of the Alarm Control is started. All messages fulfilling the selection 
criterion set in the Alarm Control are output to the printer. 


BOOL AXC_OnBtnProtocol(char* lpszPictureName, char* lpszObjectName) 


IpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 
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Return value 
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TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 


AXC_OnBitnScroll 


Function 


Syntax 


Parameters 


Return value 


External message window operation 


This function activates or deactivates the horizontal and vertical scroll functions. 


BOOL AXC_OnBtnScroll(char* lpszPictureName, char* lpszObjectName) 


lpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 
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AXC_OnBtnSelect 


Function 


Syntax 


Parameters 


Return value 


External message window operation 


This function opens the "Specify Selection" dialog for the displayed list. 


BOOL AXC_OnBtnSelect(char* lpszPictureName, char* IpszObjectName) 


IpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 


AXC_OnBtnSinglAckn 


Function 


Syntax 
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External message window operation 


This function acknowledges the currently selected message. 


BOOL AXC_OnBtnSinglAckn(char* lpszPictureName, char* lpszObjectName) 
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Parameters 


Return value 
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lpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 


AXC_OnBitnSortDig 


Function 


Syntax 


Parameters 


External operation of the message window 


This function opens the dialog for setting a user-defined sorting of the displayed messages for 
the displayed list. 


BOOL AXC_OnBtnSortDlg(char* IpszPictureName, char* IpszObjectName) 


IpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 


AXC_OnBtnTimeBase 


Function 


Syntax 


Parameters 


Return value 
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External operation of the message window 


This function opens the dialog for setting the time base for the times shown in the messages. 


BOOL AXC_OnBtnTimeBase(char* IpszPictureName, char* IlpszObjectName) 


IpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 
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AXC_OnBitnVisibleAckn 


Function 


Syntax 


Parameters 


AXC_SetFilter 


Function 


Syntax 


External message window operation 


All visible messages in the message window are acknowledged (group acknowledgement). 


BOOL AXC_OnBitnVisibleAckn(char* lpszPictureName, char* lpszObjectName) 


lpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the object name of the WinCC Alarm Control 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 


External message window operation 


This function sets a filter for WinCC Alarm Control to show a portion of the existing messages 
according to the filter criterion. 


BOOL AXC_SetFilter(char* lpszPictureName, char* IlpszObjectName, 
LPMSG_FILTER_STRUCT IpMsgFilter, LPCMN_ERROR,, IpError) 
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Parameters 


Return value 


Report 


ReportJob 


Function 


Syntax 


Parameters 
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IpszPictureName 
Pointer to the name of the picture in which the WinCC Alarm Control is located 


IpszObjectName 
Pointer to the WinCC Alarm Control name 


IpMsgFilter 
Pointer to the structure containing the filter criterion 


IpError 
Pointer to the structure of the error description 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC AlarmControl as of WinCC 
V7.0. 


Depending on the value of the lpMethod Name parameter a print job or the preview for a print 
job is started. 


void ReportJob(LPSTR IpJobName, LPSTR IpMethodName) 


IpJobName 
Pointer to the name of the print job 
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lpMethodName 


PRINTJOB Print job is started 
PREVIEW Preview of the print job is started 


Note 


This function is replaced by the RPTJobPreview and RPTJobPrint functions and should no 
longer be used. 


TagLog 


TOOLBAR_BUTTONS 


TigTableWindowPressEditRecordButton 


Function 
The editing of the table window is blocked or enabled (toggle function). 
If editing is enabled, updating of the table window is stopped at the same time. 
The updating of the table window remains to be stopped afterward, even if editing is blocked 
by a further function call. 
Syntax 
BOOL TlgTableWindowPressEditRecordButton(char* IpszWindowName) 
Parameter 


IpszWindowName 
Pointer to the window title of the WinCC Online Table Control 


Return value 


TRUE 
The function has been completed without any errors. 
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FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTableControl as of 
WinCC V7.0. 


TlgTableWindowPressFirstButton 


Function 


Syntax 


Parameter 


Return value 


Displays the first data records of the display area in the table window. 


The number of displayed data records depends on the configured time range. 


BOOL TlgTableWindowPressFirstButton(char* IpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Table Control 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTableControl as of 
WinCC V7.0. 


TigTableWindowPressHelpButton 


Function 
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Displays the online help for the table window. 
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Syntax 


Parameter 


Return value 
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BOOL TlgTableWindowPressHelpButton(char* lpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Table Control 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTableControl as of 
WinCC V7.0. 


TigTableWindowPressInsertRecordButton 


Syntax 


BOOL TlgTableWindowPressInsertRecordButton(char* IpszWindowName) 


Note 


The standard function is no longer supported for the new WinCC OnlineTableControl as of 
WinCC V7.0. 


TlgTableWindowPressLastButton 


Function 


Displays the last data records of the display area in the table window. 


The number of displayed data records depends on the configured time range. 
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Syntax 


Parameter 


Return value 


BOOL TlgTableWindowPressLastButton(char* lpszWindowName) 


lpszWindowName 
Pointer to the window title of the WinCC Online Table Control 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTableControl as of 
WinCC V7.0. 


TigTableWindowPressNextButton 


Function 


Syntax 


Parameter 


Return value 
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The data records following the current display area are displayed in the table window. 


The number of displayed data records depends on the configured time range. 


BOOL TlgTableWindowPressNextButton(char* IlpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Table Control 


TRUE 


The function has been completed without any errors. 
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FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTableControl as of 
WinCC V7.0. 


TlgTableWindowPressNextltemButton 


Function 


Syntax 


Parameter 


Return value 


The columns of the table window are moved one column to the left, the left column taking the 
position of the right column. 


BOOL TlgTableWindowPressNextltemButton(char* IpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Table Control 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTableControl as of 
WinCC V7.0. 


TlgTableWindowPressOpenArchiveVariableSelectionDlgButton 


Function 


Opens the dialog for connecting table columns to archives and tags. 
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Syntax 


Parameter 


Return value 


BOOL TlgTableWindowPressOpenArchiveVariableSelectionDlgButton(char* 
IpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Table Control 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTableControl as of 
WinCC V7.0. 


TlgTableWindowPressOpenDlgButton 


Function 


Syntax 


Parameter 


Return value 
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Opens the dialog for online configuration of the table window. 


BOOL TlgTableWindowPressOpenDlgButton(char* lpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Table Control 


TRUE 


The function has been completed without any errors. 
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FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTableControl as of 
WinCC V7.0. 


TlgTableWindowPressOpenltemSelectDigButton 


Function 


Syntax 


Parameter 


Return value 


Opens the dialog for selecting the visible columns and the first column of the table window. 


BOOL TlgTableWindowPressOpenltemSelectDigButton(char* lpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Table Control 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTableControl as of 
WinCC V7.0. 


TigTableWindowPressOpenTimeSelectDigButton 


Function 


Opens the dialog for setting the time range to be displayed in the table columns. 
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Syntax 


Parameter 


Return value 


BOOL TlgTableWindowPressOpenTimeSelectDlgButton(char* IpszWindowNumber) 


IpszWindowName 
Pointer to the window title of the WinCC Online Table Control 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTableControl as of 
WinCC V7.0. 


TlgTableWindowPressPrevButton 


Function 


Syntax 


Parameter 


Return value 
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The data records preceding the current display area are displayed in the table window. 


The number of displayed data records depends on the configured time range. 


BOOL TlgTableWindowPressPrevButton(char* lpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Table Control 


TRUE 
The function has been completed without any errors. 
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FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTableControl as of 
WinCC V7.0. 


TlgTableWindowPressPrevitemButton 


Function 


Syntax 


Parameter 


Return value 


The columns of the table window are moved one column to the right, the right column taking 
the position of the left column. 


BOOL TlgTableWindowPressPrevlitemButton(char* IpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Table Control 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTableControl as of 
WinCC V7.0. 
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TlgTableWindowPressRemoveRecordButton 


Syntax 


BOOL TlgTableWindowPressRemoveRecordButton(char* lpszWindowName) 


Note 


The standard function is no longer supported for the new WinCC OnlineTableControl as of 
WinCC V7.0. 


TigTableWindowPressStartStopButton 


Function 


Syntax 


Parameter 


Return value 


Updating of the table window is switched on or off (toggle function). 


BOOL TligTableWindowPressStartStopButton(char* lpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Table Control 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTableControl as of 
WinCC V7.0. 


TlgTrendWindowPressFirstButton 


Function 
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Displays the first data records of the display area in the trend window. 
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Syntax 


Parameter 


Return value 
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The number of displayed data records depends on the configured time range. 


BOOL TlgTrendWindowPressFirstButton(char* lpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Trend Control 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


TigTrendWindowPressHelpButton 


Function 


Syntax 


Parameter 


Return value 


Displays the online help for the trend window. 


BOOL TlgTableWindowPressNextButton(char* lpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Trend Control 


TRUE 
The function has been completed without any errors. 
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FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


TlgTrendWindowPressLastButton 


Function 


Syntax 


Parameter 


Return value 


Displays the last data records of the display area in the trend window. 


The number of displayed data records depends on the configured time range. 


BOOL TligTrendWindowPressLastButton(char* lpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Trend Control 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


TlgTrendWindowPressLinealButton 


Function 
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The ruler of the trend window is shown or hidden (toggle function). 


The ruler can be moved by means of the "cursor left" and "cursor right" buttons. 
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Syntax 


Parameter 


Return value 
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BOOL TlgTableWindowPressNextButton(char* IlpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Trend Control 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


TigTrendWindowPressNextButton 


Function 


Syntax 


Parameter 


Return value 


The data records following the current display area are displayed in the trend window. 


The number of displayed data records depends on the configured time range. 


BOOL TlgTrendWindowPressNextButton(char* IpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Trend Control 


TRUE 
The function has been completed without any errors. 
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FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


TlgTrendWindowPressNextltemButton 


Function 


Syntax 


Parameter 


Return value 


Brings all trends in the trend window one layer to the front. 


The trend in the foreground is moved into the background. 


BOOL TlgTrendWindowPressNextltemButton(char* lpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Trend Control 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


TlgTrendWindowPressOneToOneButton 


Function 
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Restores the standard size (1:1) in the trend window. 
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Syntax 


Parameter 


Return value 
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BOOL TlgTrendWindowPressOneToOneButton(char* lpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Trend Control 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


TigTrendWindowPressOpenArchiveVariableSelectionDigButton 


Function 


Syntax 


Parameter 


Return value 


Opens the dialog for connecting trends to archives and tags. 


BOOL TlgTrendWindowPressOpenArchiveVariableSelectionDlgButton(char* 
lpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Trend Control 


TRUE 
The function has been completed without any errors. 
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FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


TlgTrendWindowPressOpenDigButton 


Function 


Syntax 


Parameter 


Return value 


Opens the dialog for online configuration of the trend window. 


BOOL TlgTrendWindowPressOpenDlgButton(char* IpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Trend Control 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


TlgTrendWindowPressOpenltemSelectDligButton 


Function 
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Opens the dialog for selecting the visible trends and the trend which is to be in the foreground. 
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Syntax 


Parameter 


Return value 
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BOOL TlgTrendWindowPressOpenltemSelectDlgButton(char* lpszWindowNumber) 


IpszWindowName 
Pointer to the window title of the WinCC Online Trend Control 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


TlgTrendWindowPressOpenTimeSelectDlgButton 


Function 


Syntax 


Parameter 


Return value 


Opens the dialog for setting the time range to be displayed. 


BOOL TlgTrendWindowPressOpenTimeSelectDligButton(char* lpszWindowNumber) 


IpszWindowName 
Pointer to the window title of the WinCC Online Trend Control 


TRUE 
The function has been completed without any errors. 
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FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


TlgTrendWindowPressPrevButton 


Function 
The data records preceding the current display area are displayed in the trend window. 
The number of displayed data records depends on the configured time range. 

Syntax 
BOOL TlgTrendWindowPressPrevButton(char* IpszWindowName) 

Parameter 


IpszWindowName 
Pointer to the window title of the WinCC Online Trend Control 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


TlgTrendWindowPressPrevitemButton 


Function 
Brings all trends in the trend window one layer to the back. 


The trend in the background is moved to the foreground. 
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Syntax 


Parameter 


Return value 


2.15 ANSI-C function descriptions 


BOOL TlgTrendWindowPressPrevitemButton(char* lpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Trend Control 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


TigTrendWindowPressPrintButton 


Function 


Syntax 


Parameter 


Return value 


The current view of the trends is output in accordance with the display configured for the WinCC 
Trend Control. 


BOOL TlgTrendWindowPressPrintButton(char* IpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Trend Control 


TRUE 
The function has been completed without any errors. 
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FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


TlgTrendWindowPressReportSaveButton 


Function 


Syntax 


Parameter 


Return value 


The displayed trend window data is saved in a text file. 


BOOL TlgTrendWindowPressReportSaveButton (char* lpszWindowName) 


IpszWindowName 


Pointer to the window title of the WinCC Online Trend Control 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


TlgTrendWindowPressStartStopButton 


Function 
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Updating of the trend window is switched on or off (toggle function). 
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Syntax 


Parameter 


Return value 
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BOOL TligTrendWindowPressStartStopButton(char* lpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Trend Control 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


TlgTrendWindowPressStatsResultButton 


Function 


Syntax 


Parameter 


Return value 


Starts the evaluation of data in the selected time area. 
The statistic values minimum, maximum, average and standard deviation are calculated. 


BOOL TlgTrendWindowPressStatsResultButton(char* lpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Trend Control 


TRUE 
The function has been completed without any errors. 
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FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


TlgTrendWindowPressStatsSelectRangeButton 


Function 


Syntax 


Parameter 


Return value 


To select the time range for the statistics function, the rulers for start and end time are displayed. 


BOOL TlgTrendWindowPressStatsSelectRangeButton(char* IpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Trend Control 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


TlgTrendWindowPressZoomInButton 


Function 
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The zoom in the trend window is activated. The zoom range can only be selected with the 
mouse. 
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Syntax 


Parameter 


Return value 
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BOOL TlgTrendWindowPressZoomInButton(char* IpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Trend Control 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


TilgTrendWindowPressZoomOutButton 


Function 


Syntax 


Parameter 


Return value 


The trend window is restored to the state in which it was before the zoom was activated. The 
zoom is deactivated. 


The zoom range can only be selected with the mouse (also see 
TlgTrendWindowPressZoomI|nButton). 


BOOL TligTrendWindowPressZoomOutButton(char* lpszWindowName) 


IpszWindowName 
Pointer to the window title of the WinCC Online Trend Control 


TRUE 
The function has been completed without any errors. 
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FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


Template 
TlgGetNumberOfColumns 
Function 
Provides the number of columns in the table window. 
The window title of the corresponding WinCC Online Table Control is passed with the 
lpszTemplate parameter. 
Syntax 
int TlgGetNumberOfColumns(char* lpszTemplate) 
Parameter 


Return value 


IpszTemplate 
Pointer to the window title of the WinCC Online Table Control 


Number of colums in a table window 


Note 


The standard function is no longer supported for the new WinCC OnlineTableControl as of 
WinCC V7.0. 


TlgGetNumberOfRows 


Function 
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Provides the number of lines in the table window. 


The window title of the corresponding WinCC Online Table Control is passed with the 
lpszTemplate parameter. 
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Syntax 


Parameter 


Return value 
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int TlgGetNumberOfRows(char* IpszTemplate) 


IpszTemplate 
Pointer to the window title of the WinCC Online Table Control 


Number of lines in the table window 


Note 


The standard function is no longer supported for the new WinCC OnlineTableControl as of 
WinCC V7.0. 


TlgGetNumberOfTrends 


Function 


Syntax 


Parameter 


Return value 


Provides the number of trends in the trend window. 


The window title of the corresponding WinCC Online Trend Control is passed with the 
lpszTemplate parameter. 


int TlgGetNumberOfTrends(char* lpszTemplate) 


IpszTemplate 
Pointer to the window title of the WinCC Online Trend Control 


Number of trends in the trend window 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 
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TlgGetRowPosition 


Function 


Syntax 


Parameter 


Return value 


Provides the current position of the line pointer in the table window. 


The window title of the corresponding WinCC Online Table Control is passed with the 
lpszTemplate parameter. 


int TilgGetRowPosition(char* lpszTemplate) 


IpszTemplate 
Pointer to the window title of the WinCC Online Table Control 


Current position of the line pointer in the table window 


Note 


The standard function is no longer supported for the new WinCC OnlineTableControl as of 
WinCC V7.0. 


TlgGetRulerArchivNameTrend 


Function 


Syntax 


Parameter 
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Provides the archive name of the trend with the nTrend number in the trend window at the 
ruler position. 


The window title of the corresponding WinCC Online Trend Control is passed with the 
lpszTemplate parameter. 


char* TigGetRulerArchivNameTrend(char* IpszTemplate, int nTrend) 


IpszTemplate 
Pointer to the window title of the WinCC Online Trend Control 
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nTrend 
Number of the trend 


(0 <= nTrend <= Number of visible trends - 1) 


Archive name of the trend with the nTrend number in the trend window at the ruler position 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


TigGetRulerTimeTrend 


Function 


Syntax 


Parameter 


Return value 


Provides the time of the trend with the nTrend number in the trend window at the ruler position. 


The window title of the corresponding WinCC Online Trend Control is passed with the 
lpszTemplate parameter. 


SYSTEMTIME TlgGetRulerTimeTrend(char* lpszTemplate, int nTrend) 


IpszTemplate 
Pointer to the window title of the WinCC Online Trend Control 


nTrend 
Number of the trend 


(0 <= nTrend <= Number of visible trends - 1) 


Time of the trend with the nTrend number in the trend window at the ruler position 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 
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See also 
TlgGetRulerTimeTrend example (Page 1587) 

TlgGetRulerValueTrend 

Function 
Provides the value of the trend with the nTrend number in the trend window at the ruler position. 
The window title of the corresponding WinCC Online Trend Control is passed with the 
lpszTemplate parameter. 

Syntax 
double TigGetRulerValueTrend(char* lpszTemplate, int nTrend) 

Parameter 


Return value 


IpszTemplate 
Pointer to the window title of the WinCC Online Trend Control 


nTrend 
Number of the trend 


(0 <= nTrend <= Number of visible trends - 1) 


Value of the trend with the nTrend number in the trend window at the ruler position 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


TigGetRulerVariableNameTrend 


Function 
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Provides the tag name of the trend with the nTrend number in the trend window. 


The window title of the corresponding WinCC Online Trend Control is passed with the 
lpszTemplate parameter. 
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Syntax 


Parameter 


Return value 


TigGetTextAtPos 


Function 


Syntax 


Parameter 
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char* TigGetRulerVariableNameTrend(char* IpszTemplate, int nTrend) 


IpszTemplate 
Pointer to the window title of the WinCC Online Trend Control 


nTrend 
Number of the trend 


(0 <= nTrend <= Number of visible trends - 1) 


The tag name of the trend with the nTrend number in the trend window. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


Provides the content of a cell of the table window as text for process value archives and user 
archives. 


The cell is specified by nColumn and nLine. 


The window title of the corresponding WinCC Online Table Control is passed with the 
lpszTemplate parameter. 


char* TlgGetTextAtPos(char* lpszTemplate, int nColumn, int nLine) 


lpszTemplate 
Pointer to the window title of the WinCC Online Table Control 


nColumn 
Number of the column 
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nLine 
Number of the line 


Return value 
Content of the cell of a table window as text 


Note 
The standard function is no longer supported for the new WinCC OnlineTableControl as of 
WinCC V7.0. 
TilgGetColumnPosition 
Function 
Provides the current position of the column pointer in the table window as column index. 
Syntax 
int TlgGetColumnPosition(char* lpszTemplate) 
Parameter 


IpszTemplate 
Pointer to the window title of the WinCC Online Table Control 


Return value 


Current position of the column pointer in a table window 


Note 


The standard function is no longer supported for the new WinCC OnlineTableControl as of 
WinCC V7.0. 


TigTrendWindowActivateCurve 


Function 


Activates a certain trend in WinCC Online Trend Control via the configured name of the trend. 
This function is executed independently of the visibility or foreground position of the trend. 
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Syntax 
BOOL TlgTrendWindowActivateCurve(char* IpszPictureName, char* lpszObjectName, char* 
szValue) 

Parameter 
lpszPictureName 


Picture name 


IpszObjectName 
Name of Trend Control 


szValue 


Name of the curve 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The standard function is no longer supported for the new WinCC OnlineTrendControl as of 
WinCC V7.0. 


2.15.2.5 Report 


Report - short description 


The Report group contains functions with which to start the print preview of a print job or the 
printout itself. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 
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RPTJobPreview 
Function 

The preview of a print job is started. 
Syntax 

BOOL RPTJobPreview(LPSTR IpJobName) 
Parameters 


IpJobName 
Pointer to the name of the print job 


Return value 


TRUE 


The function has been completed without any errors. 


FALSE 
An error has occurred. 


RPTJobPrint 
Function 
A print job is started. 
Syntax 
BOOL RPTJobPrint(LPSTR IpJobName) 
Parameters 


IpJobName 
Pointer to the name of the print job 


Return value 


TRUE 


The function has been completed without any errors. 
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FALSE 
An error has occurred. 


RptShowError 


Function 
This function provides an error decription for a failed print job. 


The function is already integrated into the RptJobPrint and RetJobPreview standard functions 
and does not have to be called separately. 


The error description is displayed in a Global Script diagnostics window. 


Note 
As RptShowError is a standard function the output type and form can be changed if required. 


Please note that modified standard functions are overwritten by a WinCC installation so that 
the changes will be lost. 


Syntax 
void RptShowError ( LPCSTR pszFailedFunction, CMN_ERRORA* pCmnErrorA ) 


Parameters 


pszFailedFunction 
Pointer to the name of the failed function. 


If this pointer is NULL there will be no output of the function name. 


pCmnErrorA 

Pointer to the error structure of the failed function. 

If this pointer is NULL there will be no output of the error structure. 
STRUCTURES_TABLES_ERROR_STRUCTURE 
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2.15.2.6 


WinCC 


WinCC - short description 


GetHWDiag 


Function 


Syntax 


Parameters 


1002 


The WinCC group contains functions which affect the entire WinCC system. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


This function realizes the direct start of diagnosis at runtime triggered by an event, which must 
be configured, exercised on an object. 


If the event occurs, the hardware diagnostics function is started from STEP7 for the associated 
PLC. 


The following conditions must be fulfilled in order to use the function: 


@ The WinCC project, with the picture from which access should occur, and the STEP7 project 
must be on the same computer. 


@ The WinCC project must be stored as a subdirectory of the STEP7 project (STEP7 Projekt 
\wincproj\WinCC Projekt). 


e The S7 tags have been mapped to WinCC. 


BOOL GetHWDiag(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, LPCTSTR 
IpProperties) 


lpszPictureName 


Name of the picture (PDL file) that contains the tag that will be used for the entry point for the 
hardware diagnostics 


Since the name "IpszPictureName" stands for the current picture, entries are only required 
here in cases where it is necessary to access an object tag in a different picture. 
IpszObjectName 


Name of the object in the picture that connected with the tag that will be used for the entry 
point for the hardware diagnostics 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


ANSI-C for Creating Functions and Actions 
2.15 ANSI-C function descriptions 


Since the name "IpszObjectName" stands for the current object entries are only required here 
in cases where it is necessary to access a tag in a different object. 
lpProperties 


Name of the attribute that is connected with the tag that will be used for the entry point for the 
hardware diagnostics 


If multiple attribute are entered, they must be separated by semicolons (";"). 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


GetHWDiagLevel 


Function 


Checks the logged-in user's authorization on the basis of the User Administrator function 
number in dwLevel. 


Then, diagnostics is started directly during runtime and is triggered by an event, which has to 
be configured, occurring on an object. 


If the event occurs, the hardware diagnostics function is started from STEP7 for the associated 
PLC. 


The following conditions must be fulfilled in order to use the function: 


@ The WinCC project, with the picture from which access should occur, and the STEP7 project 
must be on the same computer. 


@ The WinCC project must be stored as a subdirectory of the STEP7 project (STEP7 Projekt 
\wincproj\WinCC Projekt). 


e The S7 tags have been mapped to WinCC. 


e In order for the user logged into WinCC to edit the hardware diagnostics dialog, the user 
must have a WinCC user authorization matching the number passed by the function call in 
the parameter "dwLevel". 


Syntax 


BOOL GetHWDiagLevel(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, LPCTSTR 
IpProperties, DWORD dw Level) 
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Parameters 


Return value 


GetKopFupAwl 


Function 


1004 


IpszPictureName 


Name of the picture (PDL file) that contains the tag that will be used for the entry point for the 
hardware diagnostics 


Since the name "IpszPictureName" stands for the current picture, entries are only required 
here in cases where it is necessary to access an object tag in a different picture. 
IpszObjectName 


Name of the object in the picture that connected with the tag that will be used for the entry 
point for the hardware diagnostics 


Since the name "IpszObjectName" stands for the current object entries are only required here 
in cases where it is necessary to access a tag in a different object. 
IpProperties 


Name of the attribute that is connected with the tag that will be used for the entry point for the 
hardware diagnostics 


If multiple attribute are entered, they must be separated by semicolons (";"). 


dwLevel 
Level number for STEP7 write permissions. 


This can be defined in User Administrator. 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


This function performs the network entry jump of WinCC into the STEP7 Editor "KFA". 
When executing this function two tasks are performed: 
@ Determination of the required date for the network entry jump from WinCC. 


e Transfer of the data to Step7 and finding the places of use of the operand in a STEP7 
program by means of AUTAPI. 
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Syntax 


Parameters 


Return value 


2.15 ANSI-C function descriptions 


BOOL GetKopFupAwl(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, LPCTSTR 
IpProperties) 


IpszPictureName 

Name of the picture (PDL file) that contains the tag that will be used for the network entry jump 
Since the name "IpszPictureName" stands for the current picture, entries are only required 
here in cases where it is necessary to access an object tag in a different picture. 
IpszObjectName 


Name of the object in the picture that connected with the tag that will be used for the network 
entry jump 


Since the name "IpszObjectName" stands for the current object entries are only required here 
in cases where it is necessary to access a tag in a different object. 
IpProperties 


Name of the attrribute that is connected with the tag that will be used for the network entry 
jump 


If multiple attribute are entered, they must be separated by semicolons (";"). 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


GetKopFupAwiLevel 


Function 


Checks the active user's authorization on the basis of the User Administrator function number 
in dwLevel and then performs the entry jump into the STEP7 Editor "KFA". 
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Syntax 


Parameters 


Return value 


1006 


When executing this function three tasks are performed: 
@ Determination of the required date for the network entry jump from WinCC. 
e Authorization check for the active user within WinCC. 


e Transfer of the data to STEP7 and finding the places of use of the operand in a STEP7 
program by means of AUTAPI. 


Note 


Depending on the result of the authorization check in WinCC the user has either only 
reading rights in STEP7 or is authorized to change S7 data. 


BOOL GetKopFupAwlLevel(LPCTSTR IlpszPictureName, LPCTSTR 
IpszObjectName,LPCTSTR IpProperties, DWORD dwLevel) 


IpszPictureName 

Name of the picture (PDL file) that contains the tag that will be used for the network entry jump 
Since the name "IpszPictureName" stands for the current picture, entries are only required 
here in cases where it is necessary to access an object tag in a different picture. 
IpszObjectName 


Name of the object in the picture that connected with the tag that will be used for the network 
entry jump 


Since the name "IpszObjectName" stands for the current object entries are only required here 
in cases where it is necessary to access a tag in a different object. 

IpProperties 

Name of the attrribute that is connected with the tag that will be used for the network entry 
jump 

If multiple attribute are entered, they must be separated by semicolons (";"). 

dwLevel 

Level number for STEP7 write permissions. 


This can be defined in User Administrator. 


TRUE 
The function has been completed without any errors. 
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FALSE 


An error has occurred. 


OnDeactivateExecute 


Function 


Syntax 


OnErrorExecute 


Function 


Syntax 


This function is called when terminating WinCC Runtime. 


As this is a standard function, you can insert instructions which are then executed. 


Note 


Concerning the instructions it must be taken into account that the Runtime is terminating and 
therefore not all functionalities are available. 


Please note that modified standard functions are overwritten by a WinCC installation so that 
the changes will be lost. 


void OnDeactivateExecute() 


OnErrorExecute is called by the system when an error occurred upon executing an action or 
a function. 


This allows you to determine the precise error cause. 
The function is called by the system and does not require an additional call. 


As this function is available as a standard function the output type and form can be changed 
if required. 


Note 


Please note that modified standard functions are overwritten by a new installation so that the 
changes will be lost. 


void OnErrorExecute(CCAPErrorExecute ErrorExecute) 
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Parameters 


ErrorExecute 


Structure informing about the error that has occurred 


Diagnostic information 


OnTime 


Function 


1008 


These information are displayed in a Global Script diagnostics window. 


SystemTime 
dwErrorCode1 


dwErrorCode2 


szErrorText 

bCycle 
szApplicationName 
szFunctionName 
szTagName 
dwCycle 
szErrorTextTagName 
status 
lpszPictureName 
IpszObjectName 
lpszPropertyName 
dwParamSize 
szErrorText 


Time (UTC) at which the error occurred 

The error codes and their meaning are to be found in the structure 
definition 

The error codes and their meaning are to be found in the structure 
definition 

Text description of the error cause 

Cycle type 

Error-triggering application 

FunctionID 

Tag name 

Cycle type 

Text description of the tag status 

Tag status 

Picture in which the error occurred 

Object in which the error occurred 

Object property in which the error occurred 

only used internally 


Text description of the error cause returned by the error structure 
"pError" 


OnTime is exclusively called by the system. The function returns the runtime of all actions or 
determines the actions running longer than the specified time. Time measurement can be 
enabled/disabled via APDIAG. 


As this function is available as a standard function the output type can be influenced by 
changing the function code. 


Note 


Please note that modified standard functions are overwritten by a WinCC installation so that 


the changes will be lost. 
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Syntax 
void OnTime(CCAPTime time) 


Parameters 


time 
Result structure 
STRUCTURES_TABLES_CCAPTIME 


2.15.2.7 Windows 
Windows - short description 


The Windows group contains the ProgramExecute function. 


This function can be used to execute any program. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 


well. 
ProgramExecute 
Function 
Starts the program with the specified name. 
Syntax 
unsigned int ProgramExecute(char* Program_Name) 
Parameters 


Program_Name 


Pointer to the program name 


Return value 


If the return value is greater than 31, the function has been completed without any errors. 
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In case of an error, the return value contains one of the following error codes: 


0 out of memory 
2 Specified file could not be found. 
3 Specified path could not be found. 
11 Program could not be started. 
2.15.3 Internal functions 
2.15.3.1 Internal functions - short description 


Internal functions are used to make graphic objects and archives dynamic and in project 
functions, standard functions and global script actions. 


Internal funtions are recognized throughout a project. 
They can be neither be newly created nor can existing internal functions be modified. 


Internal functions are divided into the following groups: 


allocate 


Functions to reserve and release working memory space 


c_bib 
Functions from the standard C-library 


graphics 
Functions to read and set properties of graphical objects 


tag 
Functions to read and write tags 


wincc 
Functions for changing languages, deactivating Runtime and ending WinCC 


2.15.3.2 allocate 


SysFree 


Function 
Releases the memory area previously reserved with the SysMalloc function. 
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Syntax 


Parameters 


SysMalloc 


Function 


Syntax 


Parameters 


2.15.3.3 


2.15 ANSI-C function descriptions 


void SysFree(void* lpFree); 


lpFree 
Pointer to the memory area reserved with the SysMalloc function 


Reserves memory space for an action. The memory area is assigned to the action. When the 
action has been completed and the result transferred, the system releases the memory again. 


The SysFree function can be used to release reserved memory space. 


void* SysMalloc(unsigned long int size); 


size 
Size of the memory area in bytes. 


c_bib 


c_bib - short description 


The function group c_bib contains C functions from the C library and is divided into: 
© ctype 

e math 

® memory 

e stdio 

e stdlib 

e string 


e time 
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ctype 


isalnum 


1012 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

© error 

e file 

e file_pos 

e output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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isdigit 


isgraph 


1014 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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islower 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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isprint 


1016 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e  stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

e error 

e file 

e file_pos 

@ output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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isspace 
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The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


isupper 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


1018 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

© error 

e file 

e file_pos 

@ output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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tolower 


toupper 


1020 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


math 


acos 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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asin 


1022 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e  stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

e error 

e file 

e file_pos 

@ output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


atan2 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


ceil 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


1024 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

© error 

e file 

e file_pos 

@ output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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cosh 


exp 


1026 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


fabs 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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floor 


1028 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e  stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

e error 

e file 

e file_pos 

@ output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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fmod 


2.15 ANSI-C function descriptions 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


frexp 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


Idexp 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 
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ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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log 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

© error 

e file 

e file_pos 

e output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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log10 


modf 
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The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


pow 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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2.15 ANSI-C function descriptions 


sin 
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You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e  stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

e error 

e file 

e file_pos 

@ output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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sinh 


2.15 ANSI-C function descriptions 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


sart 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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2.15 ANSI-C function descriptions 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


tan 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 
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ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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tanh 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

© error 

e file 

e file_pos 

@ output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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2.15 ANSI-C function descriptions 


memory 


memchr 


memcmp 
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The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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memcpy 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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2.15 ANSI-C function descriptions 


memmove 
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You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e  stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

e error 

e file 

e file_pos 

@ output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


ANSI-C for Creating Functions and Actions 


memset 


stdio 


char_io 


fgetc 


2.15 ANSI-C function descriptions 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
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2.15 ANSI-C function descriptions 


fgets 
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stdio itself is further divided into: 


string 


time 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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fputc 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

© error 

e file 

e file_pos 

e output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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fputs 


getc 
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The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


putc 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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2.15 ANSI-C function descriptions 


ungetc 
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You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e  stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

e error 

e file 

e file_pos 

@ output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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Directio 


fread 


fwrite 


2.15 ANSI-C function descriptions 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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2.15 ANSI-C function descriptions 


Error 


clearerr 
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stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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feof 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

© error 

e file 

e file_pos 

e output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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ferror 


File 


fclose 
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The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


fflush 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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2.15 ANSI-C function descriptions 


fopen 
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You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e  stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

e error 

e file 

e file_pos 

@ output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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freopen 


remove 


2.15 ANSI-C function descriptions 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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2.15 ANSI-C function descriptions 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


rename 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 
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ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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setbuf 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

© error 

e file 

e file_pos 

e output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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setvbuf 


tmpfile 
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The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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tmpnam 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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File_pos 


fgetpos 
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You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e  stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

© error 

e file 

e file_pos 

@ output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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fseek 


fsetpos 


2.15 ANSI-C function descriptions 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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2.15 ANSI-C function descriptions 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


ftell 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 
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ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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rewind 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

© error 

e file 

e file_pos 

@ output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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Output 


vfprintf 


vsprintf 
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The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


stdlib 


abs 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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2.15 ANSI-C function descriptions 


atof 
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You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e  stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

e error 

e file 

e file_pos 

@ output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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atoi 


2.15 ANSI-C function descriptions 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


atol 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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2.15 ANSI-C function descriptions 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


bsearch 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 
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ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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calloc 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

© error 

e file 

e file_pos 

@ output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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div 


free 
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The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


ANSI-C for Creating Functions and Actions 


getenv 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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labs 
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You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e  stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

e error 

e file 

e file_pos 

@ output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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Idiv 


malloc 


2.15 ANSI-C function descriptions 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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2.15 ANSI-C function descriptions 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


qsort 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 
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ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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rand 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

© error 

e file 

e file_pos 

e output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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realloc 


srand 
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The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


strtod 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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2.15 ANSI-C function descriptions 


strtol 
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You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e  stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

e error 

e file 

e file_pos 

@ output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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strtoul 


string 


streat 


2.15 ANSI-C function descriptions 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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2.15 ANSI-C function descriptions 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


strcehr 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 
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ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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strcmp 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

© error 

e file 

e file_pos 

e output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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strcpy 


strcspn 


1080 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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strerror 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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strlen 
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You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e  stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

e error 

e file 

e file_pos 

@ output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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strncat 


strncmp 


2.15 ANSI-C function descriptions 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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2.15 ANSI-C function descriptions 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


strncpy 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 
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ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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strpbrk 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

© error 

e file 

e file_pos 

@ output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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strrchr 


strspn 
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The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


strstr 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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strtok 
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You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e  stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

e error 

e file 

e file_pos 

@ output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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time 


asctime 


clock 


2.15 ANSI-C function descriptions 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 
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stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


ctime 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 
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ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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difftime 
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You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

© error 

e file 

e file_pos 

e output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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gmtime 


localtime 
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The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


ANSI-C for Creating Functions and Actions 


mktime 


stdio itself is further divided into: 


char_io 
directio 
error 
file 
file_pos 


output 


2.15 ANSI-C function descriptions 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 
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strftime 
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You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


The function group c_bib contains C functions from the C library and is divided into: 
e ctype 

e math 

® memory 

e stdio 

e  stdlib 

e string 

e time 

stdio itself is further divided into: 
e char_io 

e directio 

e error 

e file 

e file_pos 

@ output 


You can find a description of this function in related technical literature. 


Note 

The function localtime reacts as follows in respect of date output: 
Numbering of the months begins with 0. 

The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 
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time 
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The function group c_bib contains C functions from the C library and is divided into: 


stdio itself is further divided into: 


ctype 
math 
memory 
stdio 
stdlib 
string 


time 


char_io 
directio 
error 
file 
file_pos 


output 


You can find a description of this function in related technical literature. 


Note 


The function localtime reacts as follows in respect of date output: 


Numbering of the months begins with 0. 


The years are counted from 1900, beginning with 0. 


The C-library functions printf(), sprintf(), fprintf() can only process 360 characters in WinCC. 


2.15.3.4 graphics 


Graphics - short description 


The functions of the Graphics group allow to modify or query graphical properties of WinCC 
objects. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 
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get 


axes 


GetAlignment 


Function 


Syntax 


Parameters 


Return value 


See also 


1096 


Note 


If the function is called for the picture object, set the parameter lpszObjectName = ZERO. 


When using bar objects, it indicates whether the text is to the right or left of the bar. 


BOOL GetAlignment(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
Text is to the right of the bar 


FALSE 
Text is to the left of the bar 


Beispiel GetScaling (Page 1536) 
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GetAxisSection 


Function 


Syntax 


Parameters 


Return value 


GetExponent 


Function 


Syntax 


Parameters 


2.15 ANSI-C function descriptions 


When using bar objects, it specifies the difference between the values of two neighboring axis 
labels. 


double GetAxisSection(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Difference between the values of two neighboring axis labels 


When using bar objects, it specifies whether the axis label corresponds to the decimal or 
exponential form. 


BOOL GetExponent(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


TRUE 


Axis label in exponential form 


FALSE 


Axis label in decimal form 


See also 

Beispiel GetScaling (Page 1536) 
GetLeftComma 
Function 

When using bar objects, it specifies the number of integers in the axis label. 
Syntax 

long int GetLeftComma(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


The number of integers in the axis label 


GetLongStrokesBold 


Function 


When using bar objects, it specifies whether the main division lines on the scale are bold or 
regular. 


Syntax 
BOOL GetLongStrokesBold(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


WinCC: Scripting (VBS, ANSI-C, VBA) 
1098 System Manual, 02/2016, A5E37536061-AA 


ANSI-C for Creating Functions and Actions 


Parameters 


Return value 


2.15 ANSI-C function descriptions 


lpszPictureName 
Picture name 


IpszObjectName 
Object name 


TRUE 
The main division lines on the graph scale are bold 


FALSE 
The main division lines on the graph scale are regular 


See also 

Beispiel GetScaling (Page 1536) 
GetLongStrokesOnly 
Function 

When using bar objects, it specifies whether intermediate division lines are used on the scale. 
Syntax 

BOOL GetLongStrokesOnly(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


Return value 


IpszPictureName 
Picture name 


IpszObjectName 
Object name 


TRUE 
Only main division lines are used on the bar graph scale. 
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FALSE 
Both main and intermediate division lines are used on the bar graph scale. 


See also 
Beispiel GetScaling (Page 1536) 
GetLongStrokesSize 
Function 
When using bar objects, it specifies the length of the main division lines. 
Syntax 
long int GetLongStrokesSize(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Length of the main division lines as numeric value 


GetLongStrokesTextEach 


Function 
When using bar objects, it specifies the interval between the main division lines being assigned 
a label. 
Syntax 
long int GetLongStrokesTextEach(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 
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Return value 


Example: 


GetRightComma 


Function 


Syntax 


Parameters 


Return value 


GetScaleTicks 


Function 


2.15 ANSI-C function descriptions 


IpszObjectName 
Object name 


Label of the main division lines as numeric value 


Return value = 1 -> Every main division line is assigned a label. 
Return value = 2 -> Every 2nd main division line is assigned a label. 


etc. 


When using bar objects, it specifies the number of decimal places in the axis label. 


long int GetRightComma(LPCTSTR IpszPictureName, LPCTSTR lIpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


The number of decimal places in the axis label 


When using bar objects, it specifies the scale marks as number of scale sections. A scale 
section is a part of the scale bounded by two main tick marks. 
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Syntax 


Parameters 


Return value 


GetScaling 


Function 


Syntax 


Parameters 


Return value 


1102 


long int GetScaleTicks(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Scale marks as number of scale sections 


Note 


The number of scale sections is given as 0, if the bar object itself calculates a suitable scale 
unit. 


When using bar objects, it specifies whether the scale is activated or deactivated. 


BOOL GetScaling(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
Display with scale 
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FALSE 
Display without scale 


See also 
Beispiel GetScaling (Page 1536) 


GetScalingType 


Function 

When using bar objects, it specifies the type of bar scaling. 
Syntax 

long int GetScalingType(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Type of bar scaling as numeric value 


See also 
Bar Scaling (Page 1590) 
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color 


Color - short description 


GetBackColor 


Function 


Syntax 


Parameters 


Return value 


See also 


1104 


The various color properties of objects can be modified or queried using the functions in the 
Color group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


Specifies the background color of the object as a numeric value. 


long int GetBackColor(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Background color of the object as a numeric value 


Note 


If the function is called in relation to the entire picture, set the parameter lpszObjectName = 
NULL. 


GetBackColor example (Page 1518) 
Color chart (Page 1592) 
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GetBackColor2 


Function 


When using bar objects, it specifies the color of the bar as a numeric value. 


Syntax 
long int GetBackColor2(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 


Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Numeric value defining the bar color 


See also 

GetBackColor example (Page 1518) 

Color chart (Page 1592) 
GetBackColor3 
Function 

When using bar objects, it specifies the background color of the bar as a numeric value. 
Syntax 

long int GetBackColor3(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


Numeric value defining the bar background color 


See also 
GetBackColor example (Page 1518) 
Color chart (Page 1592) 
GetBackColorBottom 
Function 
Specifies the background color of the slider objects at the bottom right. 
Syntax 
long int GetBackColorBottom(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Numeric value defining the background color of the slider objects at the bottom right 


See also 
GetBackColor example (Page 1518) 
Color chart (Page 1592) 
GetBackColorTop 
Function 
Specifies the background color of the slider objects at the top left. 
Syntax 


long int GetBackColorTop(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
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Parameters 


Return value 


2.15 ANSI-C function descriptions 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Numeric value defining the background color of the slider objects at the top left 


See also 
GetBackColor example (Page 1518) 
Color chart (Page 1592) 
GetBorderBackColor 
Function 
Specifies the background color of the lines or borders. 
Syntax 
long int GetBorderBackColor(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


Return value 


See also 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Numeric value defining the background color of the lines or borders 


GetBackColor example (Page 1518) 
Color chart (Page 1592) 
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GetBorderColor 


Function 


Syntax 


Parameters 


Return value 


Specifies the line or border color as a numeric value. 


long int GetBorderColor(LPCTSTR lIpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Numeric value defining the color of lines or borders 


See also 

GetBackColor example (Page 1518) 

Color chart (Page 1592) 
GetBorderColorBottom 
Function 

Specifies the 3D border color at the bottom. 
Syntax 

long int GetBorderColorBottom(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 

IpszPictureName 

Picture name 

IpszObjectName 

Object name 
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Return value 
Numeric value defining the 3D border color at the bottom 


See also 
GetBackColor example (Page 1518) 
Color chart (Page 1592) 
GetBorderColorTop 
Function 
Specifies the 3D border color at the top. 
Syntax 
long int GetBorderColorTop(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 
Numeric value defining the 3D border color at the top 


See also 
GetBackColor example (Page 1518) 
Color chart (Page 1592) 
GetButtonColor 
Function 
Specifies the button color of slider objects. 
Syntax 


long int GetButtonColor(LPCTSTR IpszPictureName, LPCTSTR IlpszObjectName); 
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Parameters 


Return value 


See also 


GetColorBottom 


Function 


Syntax 


Parameters 


Return value 


See also 


1110 


lpszPictureName 
Picture name 


IpszObjectName 
Object name 


Numeric value defining the button color of slider objects 


GetBackColor example (Page 1518) 


Color chart (Page 1592) 


When using slider objects, it specifies the color of the bottom limit. 


long int GetColorBottom(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Numeric value defining the color of the bottom limit of slider objects 


GetBackColor example (Page 1518) 
Color chart (Page 1592) 
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GetColorTop 


Function 


Syntax 


Parameters 


Return value 


See also 


GetFillColor 


Function 


Syntax 


Parameters 


2.15 ANSI-C function descriptions 


When using slider objects, it specifies the color of the top limit. 


long int GetColorTop(LPCTSTR IpszPictureName, LPCTSTR IlpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Numeric value defining the color of the top limit of slider objects 


GetBackColor example (Page 1518) 


Color chart (Page 1592) 


Specifies the color of the fill pattern. 


long int GetFillColor(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


Numeric value of the fill color 


Note 


If the function is called in relation to the entire picture, set the parameter lpszObjectName = 
NULL. 


See also 
GetBackColor example (Page 1518) 
Color chart (Page 1592) 
GetForeColor 
Function 
Specifies the color of the font. 
Syntax 
long int GetForeColor(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Numeric value defining the font color 


See also 
GetBackColor example (Page 1518) 
Color chart (Page 1592) 
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GetGridColor 


Function 


Syntax 


Parameters 


Return value 


2.15 ANSI-C function descriptions 


Specifies the grid color of Graphics Designer. 


long int GetGridColor(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Numeric value defining the grid color of Graphics Designer 


See also 
GetBackColor example (Page 1518) 
Color chart (Page 1592) 
GetltemBorderBackColor 
Function 
Specifies the background color of the dividing line for the "text list" object. 
Syntax 
long int GetltemBorderBackColor(LPCTSTR lIpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


Numeric value defining the background color of the dividing line for the "text list" object 


See also 
GetBackColor example (Page 1518) 
Color chart (Page 1592) 
GetltemBorderColor 
Function 
Specifies the color of the dividing line for the "text list" object. 
Syntax 
long int GetltemBorderColor(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


Return value 


See also 


GetScaleColor 


Function 


Syntax 


1114 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Numeric value defining the dividing line color for the "text list" object 


GetBackColor example (Page 1518) 


Color chart (Page 1592) 


Specifies the scale color for bar objects. 


long int GetScaleColor(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 
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Parameters 


Return value 


See also 


GetSelBGColor 


Function 


Syntax 


Parameters 


Return value 


See also 


2.15 ANSI-C function descriptions 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Numeric value of the scale color for bar objects 


GetBackColor example (Page 1518) 


Color chart (Page 1592) 


Specifies the background color of the selected entry for the "text list" object. 


long int GetSelBGColor(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Numeric value defining the background color of the selected entry 


GetBackColor example (Page 1518) 
Color chart (Page 1592) 
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GetSelTextColor 


Function 


Syntax 


Parameters 


Return value 


See also 


GetTrendColor 


Function 


Syntax 


Parameters 


1116 


Specifies the font color of the selected entry for the "text list" object. 


long int GetSelTextColor(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Numeric value defining the font color of the selected entry 


GetBackColor example (Page 1518) 
Color chart (Page 1592) 


Specifies the trend color of bar objects. 


long int GetTrendColor(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


Numeric value defining the trend color of bar objects 


See also 

GetBackColor example (Page 1518) 

Color chart (Page 1592) 
GetUnselBGColor 
Function 

Specifies the background color of the non-selected entries for the "text list" object. 
Syntax 

long int GetUnselBGColor(LPCTSTR lIpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 
Numeric value defining the background color of the non-selected entries 


See also 
Color chart (Page 1592) 
GetBackColor example (Page 1518) 
GetUnselTextColor 
Function 
Specifies the font color of the non-selected entries for the "text list" object. 
Syntax 


long int GetUnselTextColor(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
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Parameters 


Return value 


See also 


fill 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Numeric value defining the font color of the non-selected entries 


GetBackColor example (Page 1518) 
Color chart (Page 1592) 


Fill - short description 


GetFilling 


Function 


Syntax 


Parameters 


1118 


The functions in the Fill group control the dynamic filling of objects. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


Specifies whether dynamic filling with background color is activated. 


BOOL GetFilling(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 


lpszPictureName 


Picture name 
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Return value 


See also 


GetFillinglndex 


Function 


Syntax 


Parameters 


Return value 


See also 


2.15 ANSI-C function descriptions 


IpszObjectName 
Object name 


TRUE 
Dynamic filling with background color is activated. 


FALSE 
Dynamic filling with background color is not activated. 


GetFilling example (Page 1519) 


Specifies the current fill level. 


long int GetFillingIndex(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Current fill level as a numeric value (0 - 100) 


GetFillingIndex example (Page 1520) 
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flash 


Flash - short description 


The various flashing properties can be modified or called in using the functions in the Flash 
group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


GetBackFlashColorOff 


Function 


Syntax 


Parameters 


Return value 


See also 


1120 


Specifies the background flash color for the deactivated status. 


long int GetBackFlashColorOff(LPCTSTR lIpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Background flash color for the deactivated status as a numeric value 


Color chart (Page 1592) 
GetFlashBackColorOn example (Page 1521) 
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GetBackFlashColorOn 


Function 


Syntax 


Parameters 


Return value 


Specifies the background flash color for the activated status. 


long int GetBackFlashColorOn(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Background flash color for the activated status as a numeric value 


See also 
GetFlashBackColorOn example (Page 1521) 
Color chart (Page 1592) 
GetBorderFlashColorOff 
Function 
Specifies the border or line flashing color for the deactivated status. 
Syntax 
long int GetBorderFlashColorOff(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


Border or line flashing color for the deactivated status as a numeric value 


See also 
GetFlashBackColorOn example (Page 1521) 
Color chart (Page 1592) 
GetBorderFlashColorOn 
Function 
Specifies the border or line flashing color for the activated status. 
Syntax 
long int GetBorderFlashColorOn(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Border or line flashing color for the activated status as a numeric value 


See also 
GetFlashBackColorOn example (Page 1521) 
Color chart (Page 1592) 
GetFlashBackColor 
Function 
Specifies whether flashing of the background is activated or not. 
Syntax 


BOOL GetFlashBackColor(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
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Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
Flashing background is activated. 


FALSE 
Flashing background is not activated. 


See also 
GetFlashBackColor example (Page 1521) 
GetFlashBorderColor 
Function 
Specifies whether flashing of the border or line is activated or not. 
Syntax 
BOOL GetFlashBorderColor(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
Flashing of the border or line is activated. 
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FALSE 
Flashing of the border or line is not activated. 


See also 
GetFlashBackColor example (Page 1521) 
GetFlashForeColor 
Function 
Specifies whether flashing of the font is activated or not. 
Syntax 
BOOL GetFlashForeColor(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
Flashing of the font is activated. 


FALSE 
Flashing of the font is not activated. 


See also 

GetFlashBackColor example (Page 1521) 
GetFlashRateBackColor 
Function 


Specifies the flash frequency of the background. 
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Syntax 
long int GetFlashRateBackColor(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 


Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Flash frequency of the background 


See also 
GetFlashBackColorOn example (Page 1521) 
Flash frequencies (Page 1590) 
GetFlashRateBorderColor 
Function 
Specifies the flash frequency of the line or border. 
Syntax 
long int GetFlashRateBorderColor(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Flash frequency of the line or border 
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See also 
GetFlashBackColorOn example (Page 1521) 
Flash frequencies (Page 1590) 
GetFlashRateForeColor 
Function 
Specifies the flash frequency of the font. 
Syntax 
long int GetFlashRateForeColor(LPCTSTR IpszPictureName, LPCTSTR lIpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Flash frequency of the font 


See also 

GetFlashBackColorOn example (Page 1521) 

Flash frequencies (Page 1590) 
GetForeFlashColorOff 
Function 

Specifies the font flash color for the deactivated status. 
Syntax 


long int GetForeFlashColorOff(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
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Parameters 


Return value 


2.15 ANSI-C function descriptions 


lpszPictureName 
Picture name 


IpszObjectName 
Object name 


Font flash color for the deactivated status as a numeric value 


See also 
GetFlashBackColorOn example (Page 1521) 
Color chart (Page 1592) 
GetForeFlashColorOn 
Function 
Specifies the font flash color for the activated status. 
Syntax 
long int GetForeFlashColorOn(LPCTSTR lIpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


Return value 


See also 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Font flash color for the activated status as a numeric value 


GetFlashBackColorOn example (Page 1521) 
Color chart (Page 1592) 
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focus 


Focus - short description 


Get_Focus 


Function 


Syntax 


Return value 


See also 


1128 


Using the functions in the Focus group, it is possible to set the focus or poll which object has 
the focus. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


Specifies the name of the object currently or last focussed. 


char *Get_Focus(); 


Name of the object currently or last focussed. 


The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 

pszValue = GetText (lpszPictureName, "Text1") ; 

if(pszValue != NULL) 


GetFocus example (Page 1523) 
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font 


2.15 ANSI-C function descriptions 


Font - short description 


The various properties affecting text can be modified or called in using the functions in the 
Font group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


GetAlignmentLeft 


Function 


Syntax 


Parameters 


Return value 


See also 


Specifies the horizontal text alignment (left, centered, right). 


long int GetAlignmentLeft(L_PCTSTR lpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Horizontal text alignment as a numeric value 


Text alignment (Page 1597) 
GetFontSize example (Page 1524) 
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GetAlignmentTop 


Function 


Syntax 


Parameters 


Return value 


See also 


GetFontBold 


Function 


Syntax 


Parameters 


1130 


Specifies the vertical text alignment (top, centered, bottom). 


long int GetAlignmentTop(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Vertical text alignment as a numeric value 


GetFontSize example (Page 1524) 
Text alignment (Page 1597) 


Specifies whether the font is bold or not. 


BOOL GetFontBold(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


TRUE 
Bold font on 


FALSE 
Bold font off 


See also 
GetFontBold example (Page 1523) 


GetFontltalic 


Function 

Specifies whether the font is italic or not. 
Syntax 

BOOL GetFontltalic(L PCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
Italic font on 


FALSE 
Italic font off 


See also 
GetFontBold example (Page 1523) 
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GetFontName 
Function 
Indicates the current font name. 
Syntax 
char* GetFontName(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 
Pointer to the name of the font currently selected. 


The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 

pszValue = GetText (lpszPictureName, "Text1") ; 

if(pszValue != NULL) 


See also 

GetText example (Page 1555) 
GetFontSize 
Function 

Specifies the font size. 
Syntax 


long int GetFontSize(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
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Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Current font size 


See also 
GetFontSize example (Page 1524) 


GetFontUnderline 


Function 

Specifies whether the font is underlined or not. 
Syntax 

BOOL GetFontUnderline(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 


Underlined font on 


FALSE 
Underlined font off 


See also 
GetFontBold example (Page 1523) 
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GetOrientation 
Function 
Specifies the text orientation (vertical/horizontal). 
Syntax 
BOOL GetOrientation(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
Vertical text orientation 


FALSE 


Horizontal text orientation 


See also 
GetFontBold example (Page 1523) 
GetText 
Function 
Specifies the value of the "text" property for objects like static text, check box or radio box. 
Syntax 
char* GetText(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 
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Return value 


See also 


general 


GetLayer 


Function 


Syntax 


Parameters 


2.15 ANSI-C function descriptions 


IpszObjectName 
Object name 


Pointer to a text. 


The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 

pszValue = GetText (lpszPictureName, "Text1") ; 

if(pszValue != NULL) 


Note 


In case of check and radio boxes, the element to be determined must be defined with the 
"Setlndex" function before actually activating this function. 


GetText example (Page 1555) 


Specifies the picture layer in which the object is located. 


long int GetLayer(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


Picture layer in which the object is located 


geometry 


Geometry - short description 


The size, position and other geometrical properties of objects can be modified or called in using 
the functions in the Geometry group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 


well. 
GetActualPointLeft 
Function 
Specifies the X value of the current position in a polygon or polygon line. 
Syntax 
long int GetActualPointLeft(_PCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


X value for the current point of a polygon or polygon line 


Note 


The current point of the polygon can be set using the SetIndex function. 
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See also 
GetLeft example (Page 1526) 
GetActualPointTop 
Function 
Specifies the Y value of the current position in a polygon or polygon line. 
Syntax 
long int GetActualPointTop(LPCTSTR IlpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Y value for the current point of a polygon or polygon line 


Note 


The current point of the polygon can be set using the SetIndex function. 


See also 
GetTop example (Page 1555) 
GetBoxCount 
Function 
Specifies the number of fields for check boxes and radio boxes. 
Syntax 


long int GetBoxCount(LPCTSTR IpszPictureName, LPCTSTR lIpszObjectName); 
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Parameters 


Return value 


GetDirection 


Function 


Syntax 


Parameters 


Return value 


See also 


GetEndAngle 


Function 


1138 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Number of fields in a check box or radio box. 


Specifies the bar direction for bar objects. 


long int GetDirection(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Bar direction of bar objects as numeric value 


Bar direction (Page 1590) 


Specifies the end angle of circle and ellipse segments and circle and elliptical arcs. 
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Syntax 


Parameters 


Return value 


GetGrid 


Function 


Syntax 


Parameters 


Return value 


2.15 ANSI-C function descriptions 


long int GetEndAngle(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


End angle of circle and ellipse segments as well as circle and ellipse arcs 


Specifies whether the grid is activated in the graphics area of Graphics Designer. 


BOOL GetGrid(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
Grid in Graphics Designer is activated. 


FALSE 
Grid in Graphics Designer is deactivated. 
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GetGridHeight 
Function 

Specifies the height of the grid in the graphics area of Graphics Designer. 
Syntax 

long int GetGridHeight(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 
Height of the grid in Graphics Designer 


GetGridWidth 
Function 

Specifies the width of the grid in the graphics area of Graphics Designer. 
Syntax 

long int GetGridWidth(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 
Width of the grid in Graphics Designer 
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GetHeight 


Function 


Syntax 


Parameters 


Return value 


See also 


GetLeft 


Function 


Syntax 


2.15 ANSI-C function descriptions 


Specifies the height of the rectangle framing an object. 


long int GetHeight(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Height of the rectangle framing an object 


Note 


If the function is called in relation to the entire picture, set the parameter lpszObjectName = 
NULL. 


GetHeight example (Page 1524) 


Specifies the X position of the upper left corner of the rectangle framing an object. 


long int GetLeft(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
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Parameters 


Return value 


See also 


GetPointCount 


Function 


Syntax 


Parameters 


Return value 


GetRadius 


Function 
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IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Current X value of the upper left corner of the rectangle framing an object 


GetLeft example (Page 1526) 


Specifies the number of corners of a polygon or in a polygon line. 


long int GetPointCount(L_PCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Number of corners of a polygon or in a polyline 


Specifies the radius of a circle, circle segment or arc. 
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Syntax 


Parameters 


Return value 


See also 


GetRadiusHeight 


Function 


Syntax 


Parameters 


Return value 


See also 


2.15 ANSI-C function descriptions 


long int GetRadius(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Radius of a circle, circle segment or arc 


GetHeight example (Page 1524) 


Specifies the radius of an ellipse, ellipse segment or elliptical arc in a vertical direction. 


long int GetRadiusHeight(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Radius of an ellipse, ellipse segment or elliptical arc in a vertical direction 


GetHeight example (Page 1524) 
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GetRadiusWidth 
Function 

Specifies the radius of an ellipse, ellipse segment or elliptical arc in a horizontal direction. 
Syntax 

long int GetRadiusWidth(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Radius of an ellipse, ellipse segment or elliptical arc in a horizontal direction 


See also 
GetHeight example (Page 1524) 


GetReferenceRotationLeft 


Function 
Specifies the X value of the rotation reference (central axis about which the object can be 
rotated) for lines, polygons and polylines. 
Syntax 
long int GetReferenceRotationLeft(_PCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


X value of the rotation reference for lines, polygons and polygon lines 


See also 
GetLeft example (Page 1526) 


GetReferenceRotationTop 


Function 
Specifies the Y value of the rotation reference (central axis about which the object can be 
rotated) for lines, polygons and polylines. 
Syntax 
long int GetReferenceRotationTop(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Y value of the rotation reference for lines, polygons and polygon lines 


See also 
GetTop example (Page 1555) 
GetRotationAngle 
Function 
Specifies the angle of rotation about the central axis for lines, polygons and polylines. 
Syntax 


long int GetRotationAngle(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 
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Parameters 


Return value 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Angle of rotation about the central axis 


See also 
GetHeight example (Page 1524) 
GetRoundCornerHeight 
Function 
Specifies the radius of the rounded corner of a rectangle vertically. 
Syntax 
long int GetRoundCornerHeight(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


Return value 


See also 


1146 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Vertical radius of the rounded corner of a rectangle 


GetHeight example (Page 1524) 
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GetRoundCornerWidth 


Function 


Specifies the radius of the rounded corner of a rectangle horizontally. 


Syntax 
long int GetRoundCornerWidth(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 


Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 
Horizontal radius of the corner of the rounded corner of a rectangle 


See also 

GetWidth example (Page 1557) 
GetStartAngle 
Function 

Specifies the start angle of circle and ellipse segments and circle and elliptical arcs. 
Syntax 

long int GetStartAngle(LPCTSTR lIpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


See also 


GetTop 


Function 


Syntax 


Parameters 


Return value 


See also 


GetWidth 


Function 


Syntax 


1148 


Start angle of circle and ellipse segments as well as circle and elliptical arcs 


GetHeight example (Page 1524) 


Specifies the Y position of the upper left corner of the rectangle framing an object. 


long int GetTop(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Current Y value of the upper left corner of the rectangle framing an object 


GetTop example (Page 1555) 


Specifies the width of the rectangle framing an object. 


long int GetWidth(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
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Parameters 


Return value 


See also 


GetZeroPoint 


Function 


Syntax 


Parameters 


Return value 


2.15 ANSI-C function descriptions 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Width of the rectangle framing an object 


Note 


If the function is called in relation to the entire picture, set the parameter lpszObjectName = 
NULL. 


GetWidth example (Page 1557) 


When using bar objects, it indicates the zero point. 


long int GetZeroPoint(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Zero point for bar objects 
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See also 
GetHeight example (Page 1524) 


i_o - short description 


The various properties affecting input and output values can be modified or called in using the 
functions in the i_o group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


GetAssignments 
Function 
Assignment of text to the value range of lists 
Syntax 
char* GetAssignments(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 
The assignment of text to the value range depends on the list type. 


The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 

pszValue = GetText (lpszPictureName, "Text1") ; 

if(pszValue != NULL) 
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See also 

List types (Page 1596) 
GetAssumeOnExit 
Function 

Specifies for I/O fields whether the entered value is assumed upon exiting the field. 
Syntax 

BOOL GetAssumeOnExit(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
Value application upon exiting the field. 


FALSE 
No value application upon exiting the field. 


GetAssumeOnFull 


Function 


Specifies for I/O fields whether the entered value is assumed on completion of input. 


Syntax 
BOOL GetAssumeOnFull(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 


Parameters 


IpszPictureName 


Picture name 
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IpszObjectName 
Object name 


Return value 


TRUE 
Value application on completion of input. 


FALSE 
No value application on completion of input. 


GetBitNumber 
Function 
Specifies the relevant bit in the output value for the "bit" list type. 
Syntax 
long int GetBitNumber(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Indication of the relevant bit in the output value for the "bit" list type 


See also 
GetHiddenInput example (Page 1525) 
List types (Page 1596) 
GetClearOnError 
Function 


Specifies for I/O fields whether deletion of the content in case of input errors is activated. 
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Syntax 


Parameters 


Return value 


GetClearOnNew 


Function 


Syntax 


Parameters 


Return value 


2.15 ANSI-C function descriptions 


BOOL GetClearOnError(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
Deletion of the content in case of input errors is activated 


FALSE 
Deletion of the content in case of input errors is not activated 


Specifies for I/O fields whether deletion of the content on new input is activated. 


BOOL GetClearOnNew(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
Deletion of the content on new input is activated. 
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GetDataFormat 


Function 


Syntax 


Parameters 


Return value 


See also 


GetHiddenInput 


Function 


Syntax 


1154 


FALSE 


Deletion of the content on new input is not activated. 


Specifies the data type of the field content for I/O fields. 


long int GetDataFormat(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Data type of the field content as numeric value 


GetHiddenInput example (Page 1525) 


I/O field, data type of the field content (Page 1592) 


Specifies whether hidden input is activated for I/O fields. 


BOOL GetHiddenInput(L_PCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
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Parameters 


Return value 


2.15 ANSI-C function descriptions 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
Hidden input is activated 


FALSE 
Hidden input is not activated 


See also 
GetHiddenInput example (Page 1525) 
GetInputValueChar 
Function 
Specifies the input value in the data type "char" for I/O fields. 
Syntax 
char* GetInputValueChar(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


Return value 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Pointer to the input value in the data type "char". 


The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 

pszValue = GetText (lpszPictureName, "Text1") ; 

if(pszValue != NULL) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 1155 


ANSI-C for Creating Functions and Actions 
2.15 ANSI-C function descriptions 


GetInputValueDouble 


Function 
Specifies the input value in the data type "double" for I/O fields. 


Syntax 
double GetInputValueDouble(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Input value in the data type "double" 


GetListType 
Function 
Specifies the list type for the "text list" object. 
Syntax 
long int GetListType(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 
List type for the "text list" object 


See also 
GetHiddenInput example (Page 1525) 
List types (Page 1596) 
GetNumberLines 
Function 
Specifies the number of visible lines for the "text list" object. 
Syntax 
long int GetNumberLines(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Number of visible lines for the "text list" object 


Note 


If the amount of configured text is larger than the number of visible lines, the "text list" object 
receives a vertical scroll bar. 


See also 

GetHiddenInput example (Page 1525) 
GetOutputFormat 
Function 


Specifies the output format for I/O fields. 
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Syntax 


Parameters 


Return value 


char* GetOutputFormat(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Pointer to the output format. 


The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 

pszValue = GetText (lpszPictureName, "Text1") ; 

if(pszValue != NULL) 


See also 

I/O field, data type of the field content (Page 1592) 

I/O field, output format (Page 1591) 
GetOutputValueChar 
Function 

Determines the output value in the data type "char" for I/O fields. This function should only be 

used if the field content of the I/O field is of the "string" data type. 
Syntax 

char* GetOutputValueChar(LPCTSTR lpszPictureName, LPCTSTR IlpszObjectName); 
Parameters 

IpszPictureName 

Picture name 
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Return value 
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IpszObjectName 
Object name 


Pointer to the output value in the data type "char". 


The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 
pszValue = GetText (lpszPictureName, "Text1") ; 


if(pszValue != NULL) 
{ 
} 
GetOutputValueDouble 
Function 
Determines the output value in the data type "double" for I/O fields. This function should only 
be used if the field content of the I/O field is not of the "string" data type. 
Syntax 
double GetOutputValueDouble(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


Return value 


See also 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Output value in the data type "double" 


GetOutputValueDouble example (Page 1529) 
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Limits 


Limits - short description 


GetAlarmHigh 


Function 


Syntax 


Parameters 


Return value 


See also 


GetAlarmLow 


Function 


1160 


The various properties affecting limit values can be modified or called in using the functions 
in the Limits group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


Specifies the upper alarm limit for bar objects. 


double GetAlarmHigh(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Upper alarm limit for bar objects 


GetAlarmHigh example (Page 1518) 


Specifies the lower alarm limit for bar objects. 
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Syntax 
double GetAlarmLow(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Lower alarm limit for bar objects 


See also 

GetAlarmHigh example (Page 1518) 
GetCheckAlarmHigh 
Function 

When using bar objects, it specifies whether the upper alarm limit is monitored. 
Syntax 

BOOL GetCheckAlarmHigh(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
In case of bar objects the upper alarm limit is monitored. 


FALSE 
In case of bar objects the upper alarm limit is not monitored. 
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See also 

GetMarker example (Page 1528) 
GetCheckAlarmLow 
Function 

When using bar objects, it specifies whether the lower alarm limit is monitored. 
Syntax 

BOOL GetCheckAlarmLow(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 


In case of bar objects the lower alarm limit is monitored. 


FALSE 


In case of bar objects the lower alarm limit is not monitored. 


See also 
GetMarker example (Page 1528) 
GetCheckLimitHigh4 
Function 
When using bar objects, it specifies whether the upper limit value reserve 4 is monitored. 
Syntax 


BOOL GetCheckLimitHigh4(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
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Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 


In case of bar objects the upper limt value reserve 4 is monitored. 


FALSE 
In case of bar objects the upper limt value reserve 4 is not monitored. 


See also 

GetMarker example (Page 1528) 
GetCheckLimitHigh5 
Function 

When using bar objects, it specifies whether the upper limit value reserve 5 is monitored. 
Syntax 

BOOL GetCheckLimitHigh5(LPCTSTR IpszPictureName, LPCTSTR IlpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
In case of bar objects the upper limt value reserve 5 is monitored. 
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FALSE 


In case of bar objects the upper limt value reserve 5 is not monitored. 


See also 

GetMarker example (Page 1528) 
GetCheckLimitLow4 
Function 

When using bar objects, it specifies whether the lower limit value reserve 4 is monitored. 
Syntax 

BOOL GetCheckLimitLow4(LPCTSTR IpszPictureName, LPCTSTR IlpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 


In case of bar objects the lower limt value reserve 4 is monitored. 


FALSE 


In case of bar objects the lower limt value reserve 4 is not monitored. 


See also 

GetMarker example (Page 1528) 
GetCheckLimitLow5 
Function 


When using bar objects, it specifies whether the lower limit value reserve 5 is monitored. 
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Syntax 
BOOL GetCheckLimitLlow5(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 


In case of bar objects the lower limt value reserve 5 is monitored. 


FALSE 


In case of bar objects the lower limt value reserve 5 is not monitored. 


See also 

GetMarker example (Page 1528) 
GetCheckToleranceHigh 
Function 

When using bar objects, it specifies whether the upper tolerance limit is monitored. 
Syntax 

BOOL GetCheckToleranceHigh(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


TRUE 


In case of bar objects the upper tolerance limit is monitored. 


FALSE 


In case of bar objects the upper tolerance limit is not monitored. 


See also 

GetMarker example (Page 1528) 
GetCheckToleranceLow 
Function 

When using bar objects, it specifies whether the lower tolerance limit is monitored. 
Syntax 

BOOL GetCheckToleranceLow(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


Return value 


See also 


1166 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 


In case of bar objects the lower tolerance limit is monitored. 


FALSE 


In case of bar objects the lower tolerance limit is not monitored. 


GetMarker example (Page 1528) 
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GetCheckWarningHigh 


Function 


Syntax 


Parameters 


Return value 


When using bar objects, it specifies whether the upper warning limit is monitored. 


BOOL GetCheckWarningHigh(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
In case of bar objects the upper warning limit is monitored. 


FALSE 
In case of bar objects the upper warning limit is not monitored. 


See also 

GetMarker example (Page 1528) 
GetCheckWarningLow 
Function 

When using bar objects, it specifies whether the lower warning limit is monitored. 
Syntax 

BOOL GetCheckWarningLow(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 
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Return value 


IpszObjectName 
Object name 


TRUE 


In case of bar objects the lower warning limit is monitored. 


FALSE 


In case of bar objects the lower warning limit is not monitored. 


See also 
GetMarker example (Page 1528) 
GetColorAlarmHigh 
Function 
Specifies the bar color for bar objects upon reaching the upper alarm limit. 
Syntax 
long int GetColorAlarmHigh(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


Return value 


See also 


1168 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Numeric value defining the bar color upon reaching the upper alarm limit 


GetBackColor example (Page 1518) 
Color chart (Page 1592) 
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GetColorAlarmLow 


Function 


Specifies the bar color for bar objects upon reaching the lower alarm limit. 


Syntax 
long int GetColorAlarmLow(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Numeric value defining the bar color upon reaching the lower alarm limit 


See also 
GetBackColor example (Page 1518) 
Color chart (Page 1592) 
GetColorLimitHigh4 
Function 
Specifies the bar color for bar objects upon reaching the upper limit reserve 4. 
Syntax 
long int GetColorLimitHigh4(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


Numeric value defining the bar color upon reaching the upper limit reserve 4 


See also 
GetBackColor example (Page 1518) 
Color chart (Page 1592) 
GetColorLimitHigh5 
Function 
Specifies the bar color for bar objects upon reaching the upper limit reserve 5. 
Syntax 
long int GetColorLimitHigh5(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Numeric value defining the bar color upon reaching the upper limit reserve 5 


See also 
GetBackColor example (Page 1518) 
Color chart (Page 1592) 
GetColorLimitLow4 
Function 
Specifies the bar color for bar objects upon reaching the lower limit reserve 4. 
Syntax 


long int GetColorLimitLow4(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
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Parameters 
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lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Numeric value defining the bar color upon reaching the lower limit reserve 4 


See also 
GetBackColor example (Page 1518) 
Color chart (Page 1592) 
GetColorLimitLow5 
Function 
Specifies the bar color for bar objects upon reaching the lower limit reserve 5. 
Syntax 
long int GetColorLimitLow5(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


Return value 


See also 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Numeric value defining the bar color upon reaching the lower limit reserve 5 


GetBackColor example (Page 1518) 
Color chart (Page 1592) 
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GetColorToleranceHigh 


Function 

Specifies the bar color for bar objects upon reaching the upper tolerance limit. 
Syntax 

long int GetColorToleranceHigh(LPCTSTR IpszPictureName, LPCTSTR IlpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Numeric value defining the bar color upon reaching the upper tolerance limit 


See also 
GetBackColor example (Page 1518) 
Color chart (Page 1592) 
GetColorToleranceLow 
Function 
Specifies the bar color for bar objects upon reaching the lower tolerance limit. 
Syntax 
long int GetColorToleranceLow(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 
Numeric value defining the bar color upon reaching the lower tolerance limit 


See also 

GetBackColor example (Page 1518) 

Color chart (Page 1592) 
GetColorWarningHigh 
Function 

Specifies the bar color for bar objects upon reaching the upper warning limit limit. 
Syntax 

long int GetColorWarningHigh(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 
Numeric value defining the bar color upon reaching the upper warning limit 


See also 
GetBackColor example (Page 1518) 
Color chart (Page 1592) 


GetColorWarningLow 


Function 
Specifies the bar color for bar objects upon reaching the lower warning limit. 


Syntax 
long int GetColorWarningLow(LPCTSTR IpszPictureName, LPCTSTR lIpszObjectName); 
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Parameters 


Return value 


See also 


GetLimitHigh4 


Function 


Syntax 


Parameters 


Return value 


See also 


1174 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Numeric value defining the bar color upon reaching the lower warning limit 


GetBackColor example (Page 1518) 


Color chart (Page 1592) 


Specifies the upper limit value for reserve 4 for bar objects. 


double GetLimitHigh4(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


High limit value for reserve 4 for bar objects 


GetAlarmHigh example (Page 1518) 
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GetLimitHigh5 


Function 


Syntax 


Parameters 


Return value 


See also 


GetLimitLow4 


Function 


Syntax 


Parameters 


2.15 ANSI-C function descriptions 


Specifies the upper limit value for reserve 5 for bar objects. 


double GetLimitHigh5(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


High limit value for reserve 5 for bar objects 


GetAlarmHigh example (Page 1518) 


Specifies the low limit value for reserve 4 for bar objects. 


double GetLimitLlow4(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


Low limit value for reserve 4 for bar objects 


See also 
GetAlarmHigh example (Page 1518) 
GetLimitLow5 
Function 
Specifies the low limit value for reserve 5 for bar objects. 
Syntax 
double GetLimitLlow5(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Low limit value for reserve 5 for bar objects 


See also 

GetAlarmHigh example (Page 1518) 
GetLimitMax 
Function 

Specifies the upper limit value for I/O fields. 
Syntax 


double GetLimitMax(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


WinCC: Scripting (VBS, ANSI-C, VBA) 
1176 System Manual, 02/2016, ASE37536061-AA 


ANSI-C for Creating Functions and Actions 
2.15 ANSI-C function descriptions 


Parameters 


lpszPictureName 
Picture name 


IpszObjectName 
Object name 


Return value 
High limit value for I/O fields 


See also 
GetAlarmHigh example (Page 1518) 
GetLimitMin 
Function 
Specifies the low limit value for I/O fields. 
Syntax 
double GetLimitMin(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 
Low limit value for I/O fields 


See also 
GetAlarmHigh example (Page 1518) 
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GetMarker 
Function 

When using bar objects, it specifies whether the limit marker is displayed. 
Syntax 

BOOL GetMarker(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
Limit marker for bar objects is displayed. 


FALSE 
Limit marker for bar objects is not displayed. 


See also 
GetMarker example (Page 1528) 
GetToleranceHigh 
Function 
Specifies the upper tolerance limit for bar objects. 
Syntax 
double GetToleranceHigh(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 
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IpszObjectName 
Object name 


Return value 


Upper tolerance limit for bar objects 


See also 
GetAlarmHigh example (Page 1518) 
GetToleranceLow 
Function 
Specifies the lower tolerance limit for bar objects. 
Syntax 
double GetToleranceLow(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Lower tolerance limit for bar objects 


See also 

GetAlarmHigh example (Page 1518) 
GetTypeAlarmHigh 
Function 


Specifies for bar objects whether the upper alarm limit is given in percentages or absolute 
terms. 
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Syntax 


Parameters 


Return value 


BOOL GetTypeAlarmHigh(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 


In case of bar objects the upper alarm limit is given in percentages. 


FALSE 
In case of bar objects the upper alarm limit is given in absolute terms. 


See also 

GetMarker example (Page 1528) 
GetTypeAlarmLow 
Function 

Specifies for bar objects whether the lower alarm limit is given in percentages or absolute terms. 
Syntax 

BOOL GetTypeAlarmLow(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 

IpszPictureName 

Picture name 

IpszObjectName 

Object name 
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Return value 
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TRUE 


In case of bar objects the lower alarm limit is given in percentages. 


FALSE 


In case of bar objects the lower alarm limit is given in absolute terms. 


See also 
GetMarker example (Page 1528) 
GetTypeLimitHigh4 
Function 
Specifies for bar objects whether the upper limit reserve 4 is given in percentages or absolute 
terms. 
Syntax 
BOOL GetTypeLimitHigh4(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


Return value 


See also 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 


In case of bar objects the upper limit reserve 4 is given in percentages. 


FALSE 


In case of bar objects the upper limit reserve 4 is given in absolute terms. 


GetMarker example (Page 1528) 
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GetTypeLimitHigh5 


Function 


Specifies for bar objects whether the upper limit reserve 5 is given in percentages or absolute 
terms. 


Syntax 
BOOL GetTypeLimitHigh5(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 


Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 


In case of bar objects the upper limit reserve 5 is given in percentages. 


FALSE 
In case of bar objects the upper limit reserve 5 is given in absolute terms. 


See also 
GetMarker example (Page 1528) 

GetTypeLimitLow4 

Function 
Specifies for bar objects whether the lower limit reserve 4 is given in percentages or absolute 
terms. 

Syntax 


BOOL GetTypeLimitLow4(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
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Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
In case of bar objects the lower limit reserve 4 is given in percentages. 


FALSE 


In case of bar objects the lower limit reserve 4 is given in absolute terms. 


See also 
GetMarker example (Page 1528) 
GetTypeLimitLow5 
Function 
Specifies for bar objects whether the lower limit reserve 5 is given in percentages or absolute 
terms. 
Syntax 
BOOL GetTypeLimitLow5(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 


In case of bar objects the lower limit reserve 5 is given in percentages. 
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FALSE 


In case of bar objects the lower limit reserve 5 is given in absolute terms. 


See also 
GetMarker example (Page 1528) 
GetTypeToleranceHigh 
Function 
Specifies for bar objects whether the upper tolerance limit is given in percentages or absolute 
terms. 
Syntax 
BOOL GetTypeToleranceHigh(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 


In case of bar objects the upper tolerance limit is given in percentages. 


FALSE 


In case of bar objects the upper tolerance limit is given in absolute terms. 


See also 

GetMarker example (Page 1528) 
GetTypeToleranceLow 
Function 


Specifies for bar objects whether the lower tolerance limit is given in percentages or absolute 
terms. 
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Syntax 
BOOL GetTypeToleranceLow(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 


In case of bar objects the lower tolerance limit is given in percentages. 


FALSE 


In case of bar objects the lower tolerance limit is given in absolute terms. 


See also 
GetMarker example (Page 1528) 
GetTypeWarningHigh 
Function 
Specifies for bar objects whether the upper warning limit is given in percentages or absolute 
terms. 
Syntax 
BOOL GetTypeWarningHigh(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


TRUE 
In case of bar objects the upper warning limit is given in percentages. 


FALSE 
In case of bar objects the upper warning limit is given in absolute terms. 


See also 
GetMarker example (Page 1528) 
GetTypeWarningLow 
Function 
Specifies for bar objects whether the lower warning limit is given in percentages or absolute 
terms. 
Syntax 
BOOL GetTypeWarningLow(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


Return value 


See also 


1186 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 


In case of bar objects the lower warning limit is given in percentages. 


FALSE 


In case of bar objects the lower warning limit is given in absolute terms. 


GetMarker example (Page 1528) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


ANSI-C for Creating Functions and Actions 
2.15 ANSI-C function descriptions 


GetWarningHigh 


Function 


Specifies the upper warning limit for bar objects. 


Syntax 
double GetWarningHigh(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Upper warning limit for bar objects 


See also 
GetAlarmHigh example (Page 1518) 
GetWarningLow 
Function 
Specifies the lower warning limit for bar objects. 
Syntax 
double GetWarningLow(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 1187 


ANSI-C for Creating Functions and Actions 


2.15 ANSI-C function descriptions 


Return value 


See also 


link 


Lower warning limit for bar objects 


GetAlarmHigh example (Page 1518) 


Link - short description 


GetLink 


Function 


Syntax 


Parameters 


1188 


A tag link property can be created or called in using the functions in the Link group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


Specifies the current tag connection of object properties. 


BOOL GetLink(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, LPCTSTR 
lpszPropertyName, LPLINKINFO *pLink); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


lpszPropertyName 

Object property 

pLink 

Pointer to a structure of the type: LINKINFO 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
Structure definition LINKINFO (Page 1605) 
GetLink example (Page 1526) 


miscs 


Miscs - short description 


The properties of objects can be modified or called in using the functions in the Miscs group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


GetAdaptBorder 
Function 
Specifies for static texts, I/O fields, check boxes and radio boxes whether the border of the 
field is to be dynamically adapted to the text size. 
Syntax 
BOOL GetAdaptBorder(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


See also 


GetAdaptPicture 


Function 


Syntax 


Parameters 


Return value 


See also 


1190 


TRUE 
Border is adapted 


FALSE 
Border is not adapted 


GetVisible example (Page 1556) 


Specifies for picture windows whether the picture is to be adapted to the window size. 


BOOL GetAdaptPicture(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
Picture is adapted 


FALSE 
Picture is not adapted 


GetVisible example (Page 1556) 
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GetAdaptSize 


Function 


Syntax 


Parameters 


Return value 


See also 


GetAverage 


Function 


Syntax 


Parameters 


2.15 ANSI-C function descriptions 


Specifies for picture windows whether the window is to be adapted. 


BOOL GetAdaptSize(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
Window is adapted 


FALSE 
Window is not adapted 


GetVisible example (Page 1556) 


When using bar objects, it specifies whether value averaging is activated. 


BOOL GetAverage(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 
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Return value 


See also 


GetBoxType 


Function 


Syntax 


Parameters 


Return value 


See also 


1192 


IpszObjectName 
Object name 


TRUE 
Averaging is activated for bar objects 


FALSE 
Averaging is not activated for bar objects 


GetVisible example (Page 1556) 


Specifies the field type (input field, output field, input/output field) for I/O fields. 


long int GetBoxType(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Field type of an I/O field 


I/O field, field type (Page 1592) 
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GetCaption 
Function 
Specifies whether a picture or application window has a title. 
Syntax 
BOOL GetCaption(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
Picture/application window has a title 


FALSE 
Picture/application window has no title 


See also 

GetVisible example (Page 1556) 
GetCloseButton 
Function 

When using a picture window, it specifies whether the window can be closed. 
Syntax 

BOOL GetCloseButton(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 
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Return value 


IpszObjectName 
Object name 


TRUE 


Picture window can be closed 


FALSE 
Picture window cannot be closed 


See also 
GetVisible example (Page 1556) 
GetColorChangeType 
Function 
When using bar objects, it specifies whether the color change upon reaching a limit value only 
affects a bar segment or the entire bar. 
Syntax 
BOOL GetColorChangeType(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


Return value 


1194 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
Color change applies to the bar sagment 


FALSE 
Color change applies to the entire bar 
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See also 
GetVisible example (Page 1556) 
GetCursorControl 
Function 
Specifies whether cursor control is activated for I/O fields. 
Syntax 
BOOL GetCursorControl(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
Cursor control for I/O fields is enabled. 


FALSE 
Cursor control for I/O fields is disabled. 


See also 
GetVisible example (Page 1556) 
GetCursorMode 
Function 
Specifies whether the cursor mode for the picture is alpha cursor or tab order cursor. 
Syntax 


BOOL GetCursorMode(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
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Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
Cursor mode for the picture is "Alpha-cursor" 


FALSE 
Cursor mode for the picture is "tab order cursor" 


See also 

GetVisible example (Page 1556) 
GetEditAtOnce 
Function 

Specifies whether the "Immediate input" property is activated for I/O fields. 
Syntax 

BOOL GetEditAtOnce(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
"Immediate input" property is activated 
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FALSE 
"Immediate input" property is deactivated 


See also 

GetVisible example (Page 1556) 
GetExtendedOperation 
Function 

Specifies whether the "Extended operation" property is activated for slider objects. 
Syntax 

BOOL GetExtendedOperation(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


Return value 


See also 


GetHotkey 


Function 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
"Extended operation" property is activated 


FALSE 
"Extended operation" property is deactivated 


GetVisible example (Page 1556) 


Specifies the key combination for check boxes. 
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Syntax 
long int GetHotkey(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 


Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Key code for key combinations for check boxes 


GetHysteresis 
Function 

When using bar objects, it specifies whether the display appears with or without hysteresis. 
Syntax 

BOOL GetHysteresis(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
Display with hysteresis for bar objects 


FALSE 
Display without hysteresis for bar objects 


See also 
GetVisible example (Page 1556) 
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GetHysteresisRange 


Function 


Specifies the hysteresis value in the display for bar objects. 


Syntax 
double GetHysteresisRange(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Hysteresis in the display for bar objects 


GetLanguageSwitch 


Function 


Specifies fot the "Text list" object whether the assignment texts are to be stored in the text 
library or in the object itself. 


Syntax 
BOOL GetLanguageSwitch(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 


Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


TRUE 
Assignment texts are stored in the text library 


FALSE 
Assignment texts are stored in the text list object 


See also 
GetVisible example (Page 1556) 
GetLastChange 
Function 
Specifies the date when the picture was last changed. 
Syntax 
char* GetLastChange(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 
Date of the last change of the picture. 


The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 

pszValue = GetText (lpszPictureName, "Text1") ; 

if(pszValue != NULL) 


See also 
GetPictureName example (Page 1531) 
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GetMax 
Function 
Specifies the maximum value for bar and slider objects. 
Syntax 
double GetMax(LPCTSTR IpszPictureName, LPCTSTR IlpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Maximum value for bar and slider objects. 


GetMaximizeButton 


Function 


Specifies for picture or application windows whether the window can be maximized. 


Syntax 
BOOL GetMaximizeButton(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 


Picture or application window can be maximized 
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See also 


GetMin 


Function 


Syntax 


Parameters 


Return value 


GetMoveable 


Function 


Syntax 


Parameters 


1202 


FALSE 


Picture or application window cannot be maximized 


GetVisible example (Page 1556) 


Specifies the minimum value for bar and slider objects. 


double GetMin(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Minimum value for bar and slider objects 


Specifies for picture or application windows whether the window can be moved. 


BOOL GetMoveable(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 
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Return value 


See also 


GetOffsetLeft 


Function 


Syntax 


Parameters 


Return value 


GetOffsetTop 


Function 


2.15 ANSI-C function descriptions 


IpszObjectName 
Object name 


TRUE 


Picture or application window is movable 


FALSE 


Picture or application window is not movable 


GetVisible example (Page 1556) 


Specifies the horizontal picture distance from the left window border for picture windows. 


long int GetOffsetLeft(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Horizontal picture distance from the left window border for picture windows 


Specifies the vertical picture distance from the upper window border for picture windows. 
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Syntax 


Parameters 


Return value 


GetOnTop 


Function 


Syntax 


Parameters 


Return value 


See also 


1204 


long int GetOffsetTop(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Vertical picture distance from the upper window border for picture windows 


Specifies for picture or application windows whether the window is always in the foreground. 


BOOL GetOnTop(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
Picture or application window is always in the foreground 


FALSE 
Picture or application window can be overlapped by other windows. 


GetVisible example (Page 1556) 
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GetOperation 
Function 
Specifies whether the object can be operated. 
Syntax 
BOOL GetOperation(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
Object is operable 


FALSE 
Object is not operable 


Note 


If the function is called in relation to the entire picture, set the parameter lpszObjectName = 
NULL. 


See also 
GetVisible example (Page 1556) 

GetOperationMessage 

Function 
Specifies for I/O fields, check boxes, radio boxes or sliders whether a message is output 
following operation. 

Syntax 


BOOL GetOperationMessage(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
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Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
Upon operation a message is issued 


FALSE 
Upon operation no message is issued 


See also 
GetVisible example (Page 1556) 
GetOperationReport 
Function 
Specifies for all objects except application and picture windows and OLE control whether the 
reason for the operation is logged. 
Syntax 
BOOL GetOperationReport(L_PCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
Reason for the operation is logged. 
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FALSE 
Reason for the operation is not logged. 


Note 


If the function is called in relation to the entire picture, set the parameter lpszObjectName = 
NULL. 


See also 
GetVisible example (Page 1556) 
GetPasswordLevel 
Function 
Specifies the authorization level for the operation of the object for all objects except application 
and picture windows and OLE control. 
Syntax 
long int GetPasswordLevel(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Authorization level for the operation of the object 


Note 


If the function is called in relation to the entire picture, set the parameter lpszObjectName = 
NULL. 
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GetPictureName 


Function 


Syntax 


Parameters 


Return value 


See also 


GetProcess 


Function 


Syntax 


1208 


Returns the name of the picture currently displayed in the picture window. 


char* GetPictureName(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Name of the picture window 


Pointer to the name of the currently displayed picture 


Note 


If both parameters are NULL, a pointer appears indicating the name of the basic screen. 


GetPictureName example (Page 1531) 


Specifies the default setting value for the process value to be displayed for bar and slider 
objects. 


Specifies the selected fields for check boxes and radio boxes. 


double GetProcess(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
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Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 
e For bar and slider objects: Default setting value for the process value to be displayed 


e For check and radio boxes: In a 32-bit word each field is represented by a bit (field 1 
corrsponds to the bit value 0). Selected fields are marked by a set bit. Non-existing are 
assigned 0. 


GetScrollBars 


Function 

Specifies for picture windows whether the window has a scroll bar. 
Syntax 

BOOL GetScrollBars(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
Picture window has a scroll bar 


FALSE 


Picture window has no scroll bar 


See also 
GetVisible example (Page 1556) 
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GetServerName 


Function 


Syntax 


Parameters 


Return value 


See also 


GetSizeable 


Function 


Syntax 


1210 


Specifies the default setting for the process value to be displayed for OLE control and OLE 
object. 


char* GetServerName(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Name of the object (OLE control and OLE object) under which it is registered in WINDOWS. 


The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 

pszValue = GetText (lpszPictureName, "Text1") ; 

if(pszValue != NULL) 


GetPictureName example (Page 1531) 


Specifies for application or picture windows whether the window size can be changed. 


BOOL GetSizeable(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 
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Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
Application or picture window is sizeable 


FALSE 
Application or picture window is not sizeable 


See also 
GetVisible example (Page 1556) 


GetSmallChange 


Function 

Specifies the number of steps for slider objects by which the slider is shifted by a mouse click. 
Syntax 

long int GetSmallChange(LPCTSTR lIpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Number of steps by which the slider is shifted by a mouse click 
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GetTagPrefix 
Function 
Returns the tag prefix of a picture window. 
Syntax 
char* GetTagPrefix(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 
Tag prefix of the picture window. 


The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 

pszValue = GetText (lpszPictureName, "Text1") ; 

if(pszValue != NULL) 


See also 
GetTagPrefix example (Page 1549) 
GetTrend 
Function 
When using bar objects, it specifies whether the trend display is activated. 
Syntax 


BOOL GetTrend(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
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Parameters 


Return value 


See also 


GetUpdateCycle 


Function 


Syntax 


Parameters 


Return value 


See also 


2.15 ANSI-C function descriptions 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
Trend display is activated for a bar object 


FALSE 
Trend display is not activated for a bar object 


GetVisible example (Page 1556) 


Specifies the update cycle for the entire picture. 


long int GetUpdateCycle(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Numeric value defining the update cycle 


Structure definition LINKINFO (Page 1605) 
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GetVisible 
Function 
Specifies whether the object is displayed. 
Syntax 
BOOL GetVisible(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 
TRUE 
Object is displayed 


FALSE 
Object is not displayed 


Note 


If the function is called in relation to the entire picture, set the parameter lpszObjectName = 
NULL. 


See also 
GetVisible example (Page 1556) 
GetWindowBorder 
Function 
Specifies for application or picture windows whether the object is displayed with a border. 
Syntax 


BOOL GetWindowBorder(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 
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Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
Application or picture window is displayed with a border. 


FALSE 
Application or picture window is displayed without a border. 


See also 
GetVisible example (Page 1556) 


GetZeroPointValue 


Function 

Specifies the absolute value of the zero point for bar objects. 
Syntax 

double GetZeroPointValue(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Absolute value of the zero point for the bar display 
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GetZoom 


Function 


Syntax 


Parameters 


Return value 


ole_control 


Specifies the scaling factor for picture windos. 


long int GetZoom(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Scaling factor of a picture window 


OLE_control - short description 


GetPosition 


Function 


1216 


The functions in the ole_Control group can only be used with OCX slider objects. 


Various OCX slider object properties and settings can be modified or called in using these 
functions. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


Specifies the position of the slider for OCX slider objects. 
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Syntax 


Parameters 


Return value 


See also 


GetRangeMax 


Function 


Syntax 


Parameters 


Return value 


See also 


2.15 ANSI-C function descriptions 


long int GetPosition(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Slider position of the OCX slider object as numeric value 


GetPosition example (Page 1532) 


Specifies the adjustment range "Max" for OCX slider objects. 


long int GetRangeMax(LPCTSTR lIpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Adjustment range "Max" of the OCX slider object as numeric value 


GetRangeMax example (Page 1534) 
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GetRangeMin 


Function 


Syntax 


Parameters 


Return value 


See also 


pictures 


Specifies the adjustment range "Min" for OCX slider objects. 


long int GetRangeMin(LPCTSTR lIpszPictureName, LPCTSTR lpszObjectName); 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Adjustment range "Min" of the OCX slider object as numeric value 


GetRangeMin example (Page 1535) 


Pictures - short description 


Various properties of pictures of graphic objects and round buttons can be modified or called 
in using the functions in the Pictures group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


GetPicDeactReferenced 


Function 


1218 


Specifies whether the picture for the "deactivated" status is referenced for round buttons. 
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Syntax 


Parameters 


Return value 


2.15 ANSI-C function descriptions 


BOOL GetPicDeactReferenced(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
The picture assigned to the "deactivated" status was not stored in the object. 


FALSE 
The picture assigned to the "deactivated" status was stored in the object. 


GetPicDeactTransparent 


Function 


Syntax 


Parameters 


Specifies the transparent color for the "deactivated" status of round buttons. 


long int GetPicDeactTransparent(L_PCTSTR lpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


See also 


Numeric value defining the transparent color for the "deactivated" status 


Note 
This function only applies to Bitmap graphics (*.bmp). 


Color chart (Page 1592) 
GetBackColor example (Page 1518) 


GetPicDeactUseTransColor 


Function 


Syntax 


Parameters 


Return value 


Specifies whether the transparent color for the "deactivated" status is used for round buttons. 


BOOL GetPicDeactUseTransColor(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
Transparent color for "deactivated" status is used 


FALSE 
Transparent color for "deactivated" status is not used 


GetPicDownReferenced 


Function 


1220 


Specifies whether the picture for the "On/pressed" status is referenced for round buttons. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


ANSI-C for Creating Functions and Actions 


Syntax 


Parameters 


Return value 


2.15 ANSI-C function descriptions 


BOOL GetPicDownReferenced(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
The picture assigned to the "On/pressed" status was not stored in the object. 


FALSE 
The picture assigned to the "On/pressed" status was stored in the object. 


GetPicDownTransparent 


Function 


Syntax 


Parameters 


Specifies the transparent color for the "On/pressed" status of round buttons. 


long int GetPicDownTransparent(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


See also 


Numeric value defining the transparent color for the "On/pressed" status 


Note 
This function only applies to Bitmap graphics (*.bmp). 


Color chart (Page 1592) 
GetPictureDown example (Page 1530) 


GetPicDownUseTransColor 


Function 


Syntax 


Parameters 


Return value 


Specifies whether the transparent color for the "On/pressed" status is used for round buttons. 


BOOL GetPicDownUseTransColor(LPCTSTR lpszPictureName, LPCTSTR IlpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
Transparent color for "On/pressed" status is used 


FALSE 
Transparent color for "On/pressed" status is not used 


GetPicReferenced 


Function 


1222 


When using graphic objects, it specifies whether the picture is referenced. 
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Syntax 


Parameters 


Return value 


2.15 ANSI-C function descriptions 


BOOL GetPicReferenced(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
The assigned picture was not stored in the object. 


FALSE 
The assigned picture was stored in the object. 


GetPicTransColor 


Function 


Syntax 


Parameters 


Specifies the transparent color for a background picture for graphic objects. 


long int GetPicTransColor(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


Numeric value defining the background picture of a graphic object 


Note 
This function only applies to Bitmap graphics (*.bmp). 


See also 
Color chart (Page 1592) 
GetBackColor example (Page 1518) 
GetPictureDeactivated 
Function 
Specifies the picture name for the "deactivated" status of round buttons. 
Syntax 
char* GetPictureDeactivated(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


Return value 


1224 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Picture name for "deactivated" status. 


The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 

pszValue = GetText (lpszPictureName, "Text1") ; 

if(pszValue != NULL) 


Note 


Bitmap files (*.bmp, *.dib) as well as metafiles (*.emf, *.wmf) can be integrated. 
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GetPictureDown 


Function 


Syntax 


Parameters 


Return value 


See also 


GetPictureUp 


Function 


2.15 ANSI-C function descriptions 


Specifies the picture name for the "On/pressed" status of round buttons. 


char* GetPictureDown(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Picture name for the "On/pressed" status. 


The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 

pszValue = GetText (lpszPictureName, "Text1") ; 

if(pszValue != NULL) 


Note 


Bitmap files (*.bmp, *.dib) as well as metafiles (*.emf, *.wmf) can be integrated. 


GetPictureDown example (Page 1530) 


Specifies the picture name for the "Off/not pressed" status of round buttons. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 1225 


ANSI-C for Creating Functions and Actions 
2.15 ANSI-C function descriptions 


Syntax 
char* GetPictureUp(LPCTSTR IpszPictureName, LPCTSTR lIpszObjectName); 


Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 
Picture name for the "Off/not pressed" status. 


The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 

pszValue = GetText (lpszPictureName, "Text1") ; 

if(pszValue != NULL) 


Note 


Bitmap files (*.bmp, *.dib) as well as metafiles (*.emf, *.wmf) can be integrated. 


See also 

GetPictureUp example (Page 1532) 
GetPicUpReferenced 
Function 

Specifies whether the picture for the "Off/not pressed" status is referenced for round buttons. 
Syntax 

BOOL GetPicUpReferenced(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 
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Return value 


2.15 ANSI-C function descriptions 


IpszObjectName 
Object name 


TRUE 
The picture assigned to the "Off/not pressed" status was not stored in the object. 


FALSE 
The picture assigned to the "Off/not pressed" status was stored in the object. 


GetPicUpTransparent 


Function 


Syntax 


Parameters 


Return value 


See also 


Specifies the transparent color for the "Off/not pressed" status of round buttons. 


long int GetPicUpTransparent(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Numeric value defining the transparent color for the "Off/not pressed" status 


Note 
This function only applies to Bitmap graphics (*.bmp). 


Color chart (Page 1592) 
GetBackColor example (Page 1518) 
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GetPicUpUseTransColor 


Function 


Syntax 


Parameters 


Return value 


Specifies whether the transparent color for the "Off/not pressed” status is used for round 
buttons. 


BOOL GetPicUpUseTransColor(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
Transparent color for "Off/not pressed" status is used 


FALSE 
Transparent color for "Off/not pressed" status is not used 


GetPicUseTransColor 


Function 


Syntax 


Parameters 


1228 


When using graphic objects, it specifies whether the transparent color is used for a background 
picture. 


BOOL GetPicUseTransColor(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 
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IpszObjectName 
Object name 


Return value 


TRUE 
Transparent color is used for a background picture. 


FALSE 
Transparent color is not used for a background picture. 


property 


Property - short description 


The properties of objects for which there are no direct functions can be modified or called in 
using the functions in the Property group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


GetPropBOOL 
Function 
Specifies the current status of a property of the data type "BOOL". 
Syntax 
BOOL GetPropBOOL(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, LPCTSTR 
lpszPropertyName) 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


See also 


GetPropChar 


Function 


Syntax 


Parameters 


Return value 


1230 


IpszPropertyName 
Name of the object property 


Value of the attribute in the data type "BOOL" 


GetPropBOOL example (Page 1533) 


Specifies the current status of a property of the data type "char". 


char* GetPropChar(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, LPCTSTR 
lpszPropertyName) 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IpszPropertyName 
Name of the object property 


Pointer to a character string containing the value of the object property. 


The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 

pszValue = GetText (lpszPictureName, "Text1") ; 

if(pszValue != NULL) 
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See also 


GetPropDouble 


Function 


Syntax 


Parameters 


Return value 


GetPropWord 


Function 


Syntax 


Parameters 


2.15 ANSI-C function descriptions 


GetPropChar example (Page 1534) 


Specifies the current status of a property of the data type "double". 


double GetPropDouble(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, LPCTSTR 
lpszPropertyName) 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IpszPropertyName 
Name of the object property 


Value of the attribute in the data type "double" 


Specifies the current status of a property of the data type "long". 


long GetPropWord(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, LPCTSTR 
lpszPropertyName) 


lpszPictureName 


Picture name 
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IpszObjectName 
Object name 


IpszPropertyName 
Name of the object property 


Return value 
Value of the attribute in the type "long" 


state 


State - short description 


The properties of status displays can be modified or called in using the functions in the State 
group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


GetBasePicReferenced 


Function 

Specifies whether the basic picture is referenced for the status display. 
Syntax 

BOOL GetBasePicReferenced(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


2.15 ANSI-C function descriptions 


TRUE 
The basic picture was not stored in the object. 


FALSE 
The basic picture was stored in the object. 


GetBasePicTransColor 


Function 


Syntax 


Parameters 


Return value 


See also 


GetBasePicture 


Function 


Specifies the transparent color of the basic picture for the status display. 


long int GetBasePicTransColor(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Transparent color of the basic picture as numeric value 


Note 
This function only applies to Bitmap graphics (*.bmp). 


Color chart (Page 1592) 
GetBackColor example (Page 1518) 


Specifies the basic picture name fur the status display. 
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Syntax 


Parameters 


Return value 


char* GetBasePicture(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Basic picture name for the status display. 


The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 

pszValue = GetText (lpszPictureName, "Text1") ; 

if(pszValue != NULL) 


GetBasePicUseTransColor 


Function 


Syntax 


Parameters 


1234 


When using the status display, it specifies whether the transparent color is used for the basic 
picture. 


BOOL GetBasePicUseTransColor(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


TRUE 
Transparent color is used for the basic picture. 


FALSE 
Transparent color is not used for the basic picture. 


GetFlashFlashPicture 


Function 
Specifies whether the flash picture of the status display is animated dynamically or statically. 


Syntax 
BOOL GetFlashFlashPicture(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


Parameters 


IpszPictureName 
Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
The flash picture is animated dynamically. 


FALSE 
The flash picture is animated statically. 


GetFlashPicReferenced 


Function 


Specifies whether the flash picture is referenced for the status display. 
Syntax 


BOOL GetFlashPicReferenced(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
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Parameters 


Return value 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
The flash picture was not stored in the object. 


FALSE 
The flash picture was stored in the object. 


GetFlashPicTransColor 


Function 


Syntax 


Parameters 


Return value 


1236 


Specifies the transparent color of the flash picture for the status display. 


long int GetFlashPicTransColor(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Transparent color of the flash picture as numeric value 


Note 
This function only applies to Bitmap graphics (*.bmp). 
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See also 


GetFlashPicture 


Function 


Syntax 


Parameters 


Return value 


2.15 ANSI-C function descriptions 


Color chart (Page 1592) 
GetBackColor example (Page 1518) 


Specifies the flash picture name for the status display. 


char* GetFlashPicture(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Flash picture name (file name of the graphic). 


The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 

pszValue = GetText (lpszPictureName, "Text1") ; 

if(pszValue != NULL) 


GetFlashPicUseTransColor 


Function 


Syntax 


When using the status display, it specifies whether the transparent color is used for the flash 
picture. 


BOOL GetFlashPicUseTransColor(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
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Parameters 


Return value 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
Transparent color is used for the flash picture. 


FALSE 
Transparent color is not used for the flash picture. 


GetFlashRateFlashPic 


Function 


Syntax 


Parameters 


Return value 


1238 


Specifies the flash frequency of the flash picture for the status display. 


long int GetFlashRateFlashPic(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Flash frequency of a flash picture as numeric value 


Note 


Since the flashing is performed by means of software engineering, the precise frequency is 
both system-dependent and hardware-bound (number of objects, processor speed, RAM size, 
update time etc.). 
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See also 
Flash frequencies (Page 1590) 
GetFlashRateFlashPic example (Page 1522) 
GetIndex 
Function 
Specifies the index of the current position in a polygon or polygon line. 
Specifies the index of the current field for check boxes and radio boxes. 
Syntax 
long int GetIndex(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Index of the current point or field 


style 


Style - short description 


Various properties affecting the appearance of objects can be modified or called in using the 
functions in the Style group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 
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GetBackBorderWidth 


Function 


Syntax 


Parameters 


Return value 


Specifies the frame width of 3D frames and slider objects. 


long int GetBackBorderWidth(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Numeric value for the frame width of 3D frames and slider objects 


See also 

GetBorderStyle example (Page 1519) 
GetBorderEndStyle 
Function 

Specifies the type of line end. 
Syntax 

long int GetBorderEndStyle(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 

IpszPictureName 

Picture name 

IpszObjectName 

Object name 
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Return value 


Type of line end as numeric value 


See also 
GetBorderStyle example (Page 1519) 
Line end style (Page 1595) 
GetBorderStyle 
Function 
Specifies the line or border style. 
Syntax 
long int GetBorderStyle(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Numeric value defining the line or border style 


See also 
GetBorderStyle example (Page 1519) 
Line styles (Page 1595) 
GetBorderWidth 
Function 
Specifies the line or border line width. 
Syntax 


long int GetBorderWidth(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
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Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


Line or border line width as numeric value 


See also 
GetBorderStyle example (Page 1519) 


GetBoxAlignment 


Function 

Specifies the arrangement of controls (left or right justified) in check boxes or radio boxes. 
Syntax 

long int GetBoxAlignment(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 
Numeric value defining the arrangement of controls in check boxes or radio boxes 


See also 
GetBorderStyle example (Page 1519) 
Text alignment (Page 1597) 
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GetFillStyle 


Function 


Syntax 


Parameters 


Return value 


See also 


GetFillStyle2 


Function 


Syntax 


2.15 ANSI-C function descriptions 


Specifies the type of fill pattern. 


long int GetFillStyle(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Type of fill pattern as numeric value 


Note 


If the function is called in relation to the entire picture, set the parameter lpszObjectName = 
NULL. 


Fill pattern (Page 1594) 
GetFillStyle example (Page 1520) 


Specifies the bar fill pattern for a bar graph. 


long int GetFillStyle2(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
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Parameters 


IpszPictureName 
Picture name 


IpszObjectName 
Object name 


Return value 


Bar fill pattern as numeric value 


See also 
Fill pattern (Page 1594) 
GetFillStyle example (Page 1520) 
GetltemBorderStyle 
Function 
Specifies the dividing line style for the "text list" object. 
Syntax 
long int GetltemBorderStyle(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 
Dividing line style for the "text list" object 


See also 
GetBorderStyle example (Page 1519) 
Line styles (Page 1595) 
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GetltemBorderWidth 


Function 
Specifies the dividing line width for the "text list" object. 


Syntax 
long int GetltemBorderWidth(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 


Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 
Numeric value defining the dividing line width for the "text list" object 


See also 
GetBorderStyle example (Page 1519) 
GetPressed 
Function 
Specifies for buttons or round buttons whether the switch setting is "pressed" or "not pressed". 
Syntax 
BOOL GetPressed(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


TRUE 
Switch setting is "pressed" 


FALSE 
Switch setting is "not pressed" 


GetToggle 
Function 

Specifies for buttons or round buttons whether the switch is latchable or not. 
Syntax 

BOOL GetToggle(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Return value 


TRUE 
Switch is latchable 


FALSE 
Switch is not latchable 


GetWindowsStyle 


Function 


Specifies whether buttons are to be displayed in Windows style. 
Syntax 


BOOL GetWindowsStyle(LPCTSTR lpszPictureName, LPCTSTR IlpszObjectName); 
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Parameters 


Return value 


set 


axes 


2.15 ANSI-C function descriptions 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
Button is displayed in the usual Windows fashion. 


FALSE 
The apperance of the button is defined by the user. 


Axes - short description 


SetAlignment 


Function 


Syntax 


The functions in the Axes group can only be used with bar graph objects. 


This function can be used to modify or query various bar graph object properties. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


When using bar objects, it indicates whether the text is to the right or left of the bar. 


BOOL SetAlignment(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, BOOL 
bAlignment); 
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Parameters 


Return value 


See also 


SetAxisSection 


Function 


Syntax 


Parameters 


1248 


IpszPictureName 
Picture name 


IpszObjectName 
Object name 


bAlignment 
Text alignment 


TRUE Text is to the right of the bar 
FALSE Text is to the left of the bar 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetScaling example (Page 1569) 


When using bar objects, it specifies the axis section, i.e. the difference between the values of 
two neighboring axis labels. 


BOOL SetAxisSection(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, double 
dAxisSection); 


IpszPictureName 
Picture name 


IpszObjectName 
Object name 
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dAxisSection 
Axis section 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetScaling example (Page 1569) 
SetExponent 
Function 
Sets the axis label display for bar objects (exponential/decimal). 
Syntax 
BOOL SetExponent(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, BOOL 
bExponent); 
Parameters 
lpszPictureName 


Picture name 


IpszObjectName 
Object name 


bExponent 
Axis labeling 


TRUE Axis label in exponential form 
FALSE Axis label in decimal form 


Return value 


TRUE 
The function has been completed without any errors. 
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See also 


SetLeftComma 


Function 


Syntax 


Parameters 


Return value 


See also 


1250 


FALSE 
An error has occurred. 


SetScaling example (Page 1569) 


When using bar objects, it specifies the number of integers in the axis label. 


BOOL SetLeftComma(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 


ILeftComma); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


lLeftComma 
Number of integers 


TRUE 


The function has been completed without any errors. 


FALSE 


An error has occurred. 


SetScaling example (Page 1569) 
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SetLongStrokesBold 


Function 


Syntax 


Parameters 


Return value 


When using bar objects, it specifies whether the main division lines are bold or regular. 


BOOL SetLongStrokesBold(LPCTSTR lIpszPictureName, LPCTSTR IpszObjectName, BOOL 
bLongStrokesBold); 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


bLongStrokesBold 
Main division lines on the bar graph scale 


TRUE bold 
FALSE normal 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 

SetScaling example (Page 1569) 
SetLongStrokesOnly 
Function 


When using bar objects, it specifies whether intermediate or only main division lines are used 
on the scale. 
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Syntax 
BOOL SetLongStrokesOnly(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, BOOL 
bLongStrokesOnly); 

Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bLongStrokesOnly 


Only main division lines yes/no 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetScaling example (Page 1569) 
SetLongStrokesSize 
Function 
When using bar objects, it specifies the length of the main division lines on the bar graph scale. 
Syntax 
BOOL SetLongStrokesSize(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, long int 
ILongStrokesSize); 
Parameters 
IpszPictureName 


Picture name 
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Return value 


See also 


SetRightComma 


Function 


Syntax 


Parameters 


Return value 


2.15 ANSI-C function descriptions 


IpszObjectName 
Object name 


lLongStrokesSize 
Length of the main division marks in pixels 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetScaling example (Page 1569) 


When using bar objects, it specifies the number of decimal places in the axis label. 


BOOL SetRightComma(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, long int 
IRightComma); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IRightComma 
Number of decimal places 


TRUE 
The function has been completed without any errors. 
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FALSE 


An error has occurred. 


See also 
SetScaling example (Page 1569) 

SetScaleTicks 

Function 
When using bar objects, it specifies the scale marks as number of scale sections. A scale 
section is a part of the scale bounded by two main tick marks. 

Syntax 
BOOL SetScaleTicks(LPCTSTR IpszPictureName, LPCTSTR lIpszObjectName, long int 
IScaleTicks); 

Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IScaleTicks 
Number of scale sections 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


If the number of scale sections is given as 0, the bar object itself calculates a suitable scale 
unit. 
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See also 
SetScaling example (Page 1569) 
SetScaling 
Function 
Switches the bar graph scale of bar objects on or off. 
Syntax 
BOOL SetScaling(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, BOOL bScaling); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bScaling 
Scale on/off. 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetScaling example (Page 1569) 


SetScalingType 


Function 


When using bar objects, it specifies the type of bar scaling. 
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Syntax 


Parameters 


Return value 


See also 


color 


BOOL SetScalingType(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IScalingType); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IScalingType 
Type of bar scaling as numeric value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Bar Scaling (Page 1590) 
SetScaling example (Page 1569) 


Color - short description 


1256 


The various color properties of objects can be modified or queried using the functions in the 
Color group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 
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SetBackColor 


Function 


Syntax 


Parameters 


Return value 


See also 


2.15 ANSI-C function descriptions 


Sets the background color of the object. 


BOOL SetBackColor(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IBackColor); 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


IBackColor 
Background color of the object as a numeric value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


If the function is called in relation to the entire picture, set the parameter lpszObjectName = 
NULL. 


Color chart (Page 1592) 
SetBackColor example (Page 1559) 
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SetBackColor2 
Function 
Sets the bar color for bar objects. 
Syntax 
BOOL SetBackColor2(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IBackColor2); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IBackColor2 
Numeric value defining the bar color 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 

Color chart (Page 1592) 

SetBackColor example (Page 1559) 
SetBackColor3 
Function 

Sets the bar background color for bar objects. 
Syntax 


BOOL SetBackColor3(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IBackColor3); 
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Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


IBackColor3 
Numeric value defining the bar background color 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
SetBackColorBottom 
Function 
Sets the background color of the slider objects at the bottom right. 
Syntax 
BOOL SetBackColorBottom(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long 
int IBackColorBottom); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IBackColorBottom 
Numeric value defining the background color of slider objects 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
SetBackColorTop 
Function 
Sets the background color of the slider objects at the top left. 
Syntax 
BOOL SetBackColorTop(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IBackColorTop); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IBackColorTop 
Numeric value defining the background color of slider objects 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 
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See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
SetBorderBackColor 
Function 
Sets the background color of the lines or borders. 
Syntax 
BOOL SetBorderBackColor(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, long int 
IBorderBackColor); 
Parameters 
lpszPictureName 


Picture name 


IpszObjectName 
Object name 


IBorderBackColor 
Background color of the lines or borders 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
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SetBorderColor 

Function 
Sets the color of the lines or borders. 

Syntax 
BOOL SetBorderColor(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, long int 
IBorderColor); 

Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IBorderColor 
Numeric value defining the color of lines or borders 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 

Color chart (Page 1592) 

SetBackColor example (Page 1559) 
SetBorderColorBottom 
Function 

Sets the 3D border color at the bottom. 
Syntax 


BOOL SetBorderColorBottom(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long 
int IBorderColorBottom); 
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Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


IBorderColorBottom 
Numeric value defining the 3-D border color at the bottom 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
SetBorderColorTop 
Function 
Sets the 3D border color at the top. 
Syntax 
BOOL SetBorderColorTop(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, long int 
IBorderColorTop); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IBorderColorTop 
Numeric value defining the 3-D border color at the top 
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Return value 


See also 


SetButtonColor 


Function 


Syntax 


Parameters 


Return value 


1264 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Color chart (Page 1592) 
SetBackColor example (Page 1559) 


Sets the button color of slider objects. 


BOOL SetButtonColor(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IButtonColor); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IButtonColor 
Numeric value defining the button color of slider objects 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 
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See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
SetColorBottom 
Function 
When using slider objects, it sets the color of the bottom limit. 
Syntax 
BOOL SetColorBottom(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IColorBottom); 
Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


IColorBottom 
Numeric value defining the color of the bottom limit of slider objects 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
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SetColorTop 
Function 
When using slider objects, it sets the color of the top limit. 
Syntax 
BOOL SetColorTop(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IColorTop); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IColorTop 
Numeric value defining the color of the top limit of slider objects 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
SetFillColor 
Function 
Sets the color of the fill pattern. 
Syntax 


BOOL SetFillColor(LPCTSTR lpszPictureName, LPCTSTR IlpszObjectName, long int 
IFillColor); 
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Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


IFillColor 
Numeric value of the fill color 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


If the function is called in relation to the entire picture, set the parameter lpszObjectName = 
NULL. 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
SetForeColor 
Function 
Sets the font color. 
Syntax 
BOOL SetForeColor(LPCTSTR IlpszPictureName, LPCTSTR lpszObjectName, long int 
IForeColor); 
Parameters 
IpszPictureName 


Picture name 
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Return value 


IpszObjectName 
Object name 


|ForeColor 
Numeric value defining the font color 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
SetltemBorderBackColor 
Function 
Sets the background color of the separating line for the "text list" object. 
Syntax 
BOOL SetltemBorderBackColor(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, 
long int IltemBorderBackColor); 
Parameters 
IpszPictureName 
Picture name 
IpszObjectName 
Object name 
IltemBorderBackColor 
Background color of the dividing line as a numeric value 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
SetltemBorderColor 
Function 
Sets the color of the dividing line for the "text list" object. 
Syntax 
BOOL SetltemBorderColor(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, long int 
IltemBorderColor); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IltemBorderColor 
Numeric value defining the dividing line color 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 1269 


ANSI-C for Creating Functions and Actions 


2.15 ANSI-C function descriptions 


See also 


SetScaleColor 


Function 


Syntax 


Parameters 


Return value 


See also 


1270 


Color chart (Page 1592) 
SetBackColor example (Page 1559) 


Sets the scale color for bar objects. 


BOOL SetScaleColor(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IScaleColor); 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


IScaleColor 
Numeric value of the scale color for bar objects 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Color chart (Page 1592) 
SetBackColor example (Page 1559) 
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SetSelBGColor 


Function 


Sets the background color of the selected entry for the "text list" object. 


Syntax 
BOOL SetSelBGColor(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
ISelBGColor); 

Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


ISelBGColor 
Numeric value defining the background color in the selected entry 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
SetSelTextColor 
Function 
Sets the font color of a selected entry for the "text list" object. 
Syntax 


BOOL SetSelTextColor(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, long int 
ISelTextColor); 
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Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


ISelTextColor 
Numeric value defining the font color in the selected entry 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
SetTrendColor 
Function 
Sets the trend color for bar objects. 
Syntax 
BOOL SetTrendColor(LPCTSTR lIpszPictureName, LPCTSTR IpszObjectName, long int 
ITrendColor); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


ITrendColor 
Numeric value defining the trend color 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
SetUnselBGColor 
Function 
Sets the background color of non-selected entries for the "text list" object. 
Syntax 
BOOL SetUnselBGColor(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, long int 
IUnselBGColor); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


lUnselBGColor 
Numeric value defining the background color for non-selected entries 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 
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See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
SetUnselTextColor 
Function 
Sets the font color of non-selected entries for the "text list" object. 
Syntax 
BOOL SetUnselTextColor(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IUnselTextColor); 
Parameters 


Return value 


See also 


1274 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


lUnselTextColor 
Numeric value defining the font color for non-selected entries 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Color chart (Page 1592) 
SetBackColor example (Page 1559) 
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2.15 ANSI-C function descriptions 


Fill - short description 


SetFilling 


Function 


Syntax 


Parameters 


Return value 


See also 


The functions in the Fill group control the dynamic filling of objects. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


Activates or deactivates dynamic filling with background color. 


BOOL SetFilling(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, BOOL bFilling); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bFilling 
Dynamic filling with background color on/off 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetFilling example (Page 1561) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 1275 


ANSI-C for Creating Functions and Actions 
2.15 ANSI-C function descriptions 


SetFillinglndex 


Function 
Sets the fill level. 
Syntax 
BOOL SetFillingindex(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IFillingindex); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IFillingIndex 
Fill level as a numeric value (0 - 100) 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetFillinglndex example (Page 1561) 
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flash 


Flash - short description 


The various flashing properties can be modified or called in using the functions in the Flash 
group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 


well. 
SetBackFlashColorOff 
Function 
Sets the background flash color for the deactivated status. 
Syntax 
BOOL SetBackFlashColorOff(LPCTSTR lpszPictureName, LPCTSTR IlpszObjectName, long 
int IBackFlashColorOff); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IBackFlashColorOff 
Background flash color for the deactivated status as a numeric value 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 
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See also 
Color chart (Page 1592) 
SetFlashBackColorOn example (Page 1562) 
SetBackFlashColorOn 
Function 
Sets the background flash color for the activated status. 
Syntax 
BOOL SetBackFlashColorOn(LPCTSTR IpszPictureName, LPCTSTR IlpszObjectName, long 
int IBackFlashColorOn); 
Parameters 


Return value 


See also 


1278 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IBackFlashColorOn 


Background flash color for the activated status as a numeric value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Color chart (Page 1592) 
SetFlashBackColorOn example (Page 1562) 
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SetBorderFlashColorOff 


Function 


Syntax 


Parameters 


Return value 


Sets the border or line flashing color for the deactivated status. 


BOOL SetBorderFlashColorOff(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, 
long int IBorderFlashColorOff); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IBorderFlashColorOff 
Border or line flashing color for the deactivated status as a numeric value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
SetFlashBackColorOn example (Page 1562) 
Color chart (Page 1592) 
SetBorderFlashColorOn 
Function 
Sets the border or line flashing color for the activated status. 
Syntax 


BOOL SetBorderFlashColorOn(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, 
long int IBorderFlashColorOn); 
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Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IBorderFlashColorOn 
Border or line flashing color for the activated status as a numeric value 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
Color chart (Page 1592) 
SetFlashBackColorOn example (Page 1562) 
SetFlashBackColor 
Function 
Activates or deactivates background flashing. 
Syntax 
BOOL SetFlashBackColor(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, BOOL 
bFlashBackColor); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bFlashBackColor 
Flashing background on/off 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetFlashBackColor example (Page 1562) 
SetFlashBorderColor 
Function 
Activates or deactivates flashing of the border or line. 
Syntax 
BOOL SetFlashBorderColor(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, BOOL 
bFlashBorderColor); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bFlashBorderColor 
Flashing of the border or line on/off 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
SetFlashBackColor example (Page 1562) 
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SetFlashForeColor 


Function 


Activates or deactivates font flashing. 


Syntax 
BOOL SetFlashForeColor(L_PCTSTR IpszPictureName, LPCTSTR lpszObjectName, BOOL 
bFlashForeColor); 

Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bFlashForeColor 
Flashing of the font on/off 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 

SetFlashBackColor example (Page 1562) 
SetFlashRateBackColor 
Function 

Sets the flash frequency of the background. 
Syntax 


BOOL SetFlashRateBackColor(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, 
long int IFlashRateBackColor); 
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Parameters 


Return value 


See also 


2.15 ANSI-C function descriptions 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


IFlashRateBackColor 
Flash frequency of the background 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Flash frequencies (Page 1590) 
SetFlashBackColor example (Page 1562) 


SetFlashRateBorderColor 


Function 


Syntax 


Parameters 


Sets the flash frequency of the line or border. 


BOOL SetFlashRateBorderColor(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, 
long int IFlashRateBorderColor); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IFlashRateBorderColor 
Flash frequency of the line or border 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
Flash frequencies (Page 1590) 
SetFlashBackColor example (Page 1562) 
SetFlashRateForeColor 
Function 
Sets the flash frequency of the font. 
Syntax 
BOOL SetFlashRateForeColor(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, 
long int IFlashRateForeColor); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IFlashRateForeColor 
Flash frequency of the font 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 
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See also 
Flash frequencies (Page 1590) 
SetFlashBackColor example (Page 1562) 
SetForeFlashColorOff 
Function 
Sets the font flash color for the deactivated status. 
Syntax 
BOOL SetForeFlashColorOff(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long 
int IForeFlashColorOff); 
Parameters 


Return value 


See also 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


IForeFlashColorOff 
Font flash color for the deactivated status as a numeric value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Color chart (Page 1592) 
SetFlashBackColorOn example (Page 1562) 
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SetForeFlashColorOn 


Function 


Syntax 


Parameters 


Return value 


See also 


1286 


Sets the font flash color for the activated status. 


BOOL SetForeFlashColorOn(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long 


int IForeFlashColorOn); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IForeFlashColorOn 


Font flash color for the activated status as a numeric value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Color chart (Page 1592) 
SetFlashBackColorOn example (Page 1562) 
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2.15 ANSI-C function descriptions 


Focus - short description 


Set_Focus 


Function 


Syntax 


Parameters 


Return value 


See also 


Using the functions in the Focus group, it is possible to set the focus or poll which object has 
the focus. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


Sets the focus on the specified object. 


BOOL Set_Focus(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetFocus example (Page 1563) 
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font 


Font - short description 


The various properties affecting text can be modified or called in using the functions in the 
Font group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


SetAlignmentLeft 


Function 
Sets the horizontal text alignment (left, centered, right). 

Syntax 
BOOL SetAlignmentLeft(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, long int 
l[AlignmentLeft); 

Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


lAlignmentLeft 


Horizontal text alignment as a numeric value 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 
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See also 
Text alignment (Page 1597) 
SetFontSize example (Page 1564) 


SetAlignmentTop 


Function 
Sets the vertical text alignment (top, centered, bottom). 

Syntax 
BOOL SetAlignmentTop(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, long int 
l[AlignmentTop); 

Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


lAlignmentTop 
Vertical text alignment as a numeric value 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
Text alignment (Page 1597) 
SetFontSize example (Page 1564) 
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SetFontBold 


Function 


Syntax 


Parameters 


Return value 


See also 


SetFontitalic 


Function 


Syntax 


1290 


Switches the bold font on or off. 


BOOL SetFontBold(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, BOOL 


bFontBold); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bFontBold 
Bold font on/off 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetFontBold example (Page 1563) 


Switches the italic font on or off. 


BOOL SetFontltalic(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, BOOL 


bFontitalic); 
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Parameters 


Return value 


See also 


SetFontName 


Function 


Syntax 


Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


bFontitalic 
Italic font on/off 


TRUE 


2.15 ANSI-C function descriptions 


The function has been completed without any errors. 


FALSE 


An error has occurred. 


SetFontBold example (Page 1563) 


Sets a font. 


BOOL SetFontName(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, char* 


szFontName); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


szFontName 


Pointer to name of font 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
SetText example (Page 1578) 
SetFontSize 
Function 
Sets the font size. 
Syntax 
BOOL SetFontSize(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, long int 
IFontSize); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IFontSize 


Font Size 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
SetFontSize example (Page 1564) 
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SetFontUnderline 


Function 
Switches the underlined font on or off. 

Syntax 
BOOL SetFontUnderline(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, BOOL 
bFontUnderline); 

Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bFontUnderline 


Underlined font on/off 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 

SetFontBold example (Page 1563) 
SetOrientation 
Function 

Defines the text orientation (vertical/horizontal). 
Syntax 


BOOL SetOrientation(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, BOOL 
bOrientation); 
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Parameters 


Return value 


See also 


SetText 


Function 


Syntax 


Parameters 


1294 


IpszPictureName 
Picture name 


IpszObjectName 
Object name 


bOrientation 
Text orientation 


TRUE _ vertical 
FALSE Horizontal 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetFontBold example (Page 1563) 


Sets the value of the "text" property for objects like static text, check box or radio box. 


BOOL SetText(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, char* szText); 


IpszPictureName 
Picture name 


IpszObjectName 
Object name 
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szText 
Pointer to a text 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


In case of check and radio boxes the element to be changed must be defined with the SetIndex 
function before actually activating this function. 


See also 
SetText example (Page 1578) 


geometry 


Geometry - short description 


The size, position and other geometrical properties of objects can be modified or called in using 
the functions in the Geometry group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 


well. 
SetActualPointLeft 
Function 

Sets the X value for the current point of a polygon or polygon line. 
Syntax 


BOOL SetActualPointLeft(_PCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
[ActualPointLeft); 
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Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


lActualPointLeft 
X value for the current point of a polygon or polygon line 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


The current point of the polygon can be set using the Setlndex function. 


See also 
SetLeft example (Page 1565) 
SetActualPointTop 
Function 
Sets the Y value for the current point of a polygon or polygon line. 
Syntax 
BOOL SetActualPointTop(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, long int 
[ActualPointTop); 
Parameters 
lpszPictureName 


Picture name 


IpszObjectName 
Object name 
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lActualPointTop 
Y value for the current point of a polygon or polygon line 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


The current point of the polygon can be set using the Setlndex function. 


See also 
SetTop example (Page 1578) 
SetBoxCount 
Function 
Sets the number of fields in a check box or radio box. 
Syntax 
BOOL SetBoxCount(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IBoxCount); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IBoxCount 
Number of fields in a check box or radio box. 
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Return value 


SetDirection 


Function 


Syntax 


Parameters 


Return value 


See also 


1298 


TRUE 


The function has been completed without any errors. 


FALSE 


An error has occurred. 


Sets the bar direction for bar objects. 


BOOL SetDirection(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, long int 


IDirection); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IDirection 
Numeric value defining the bar direction 


TRUE 


The function has been completed without any errors. 


FALSE 
An error has occurred. 


Bar direction (Page 1590) 
SetTop example (Page 1578) 
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SetEndAngle 
Function 
Sets the end angle of circle and ellipse segments and circle and elliptical arcs. 
Syntax 
BOOL SetEndAngle(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, long int 
IEndAngle); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IEndAngle 
End angle of circle and ellipse segments as well as circle and ellipse arcs 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
SetTop example (Page 1578) 
SetHeight 
Function 
Sets the height of the rectangle framing an object. 
Syntax 


BOOL SetHeight(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int IHeight); 
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Parameters 


Return value 


See also 


SetLeft 


Function 


Syntax 


Parameters 


1300 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


lHeight 
Height of the framing rectangle 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


If the function is called in relation to the entire picture, set the parameter lpszObjectName = 
NULL. 


SetHeight example (Page 1564) 


Sets the X value of the upper left corner of the rectangle framing an object 


BOOL SetLeft(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, long int ILeft); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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lLeft 
X value of the upper left corner of the framing rectangle 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetLeft example (Page 1565) 
SetPointCount 
Function 
Sets the number of corners of a polygon or in a polygon line. 
Syntax 
BOOL SetPointCount(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IPointCount); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IPointCount 


Number of corner points 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 
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See also 
SetLeft example (Page 1565) 
SetRadius 
Function 
Sets the radius of a circle, circle segment or arc. 
Syntax 
BOOL SetRadius(LPCTSTR lpszPictureName, LPCTSTR IlpszObjectName, long int IRadius); 
Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


IRadius 
Radius 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetHeight example (Page 1564) 


SetRadiusHeight 


Function 


Sets the radius of an ellipse, ellipse segment or elliptical arc in vertical direction. 
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Syntax 


BOOL SetRadiusHeight(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IRadiusHeight); 


Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IRadiusHeight 
Radius in vertical direction 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetHeight example (Page 1564) 
SetRadiusWidth 
Function 
Sets the radius of an ellipse, ellipse segment or elliptical arc in horizontal direction. 
Syntax 
BOOL SetRadiusWidth(LPCTSTR lIpszPictureName, LPCTSTR IpszObjectName, long int 
IRadiusWidth); 
Parameters 


IpszPictureName 


Picture name 
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IpszObjectName 
Object name 


IRadiusWidth 
Radius in horizontal direction 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetWidth example (Page 1579) 


SetReferenceRotationLeft 


Function 
Sets the X value of the rotation reference (central axis about which the object can be rotated) 
for lines, polygons and polylines. 

Syntax 
BOOL SetReferenceRotationLeft(_PCTSTR IpszPictureName, LPCTSTR IpszObjectName, 
long int IReferenceRotationLeft); 

Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IReferenceRotationLeft 


X value of the rotation reference 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetLeft example (Page 1565) 


SetReferenceRotationTop 


Function 
Sets the Y value of the rotation reference (central axis about which the object can be rotated) 
for lines, polygons and polylines. 

Syntax 
BOOL SetReferenceRotationTop(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, 
long int IReferenceRotationTop); 

Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IReferenceRotationTop 
Y value of the rotation reference 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 
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See also 
SetTop example (Page 1578) 
SetRotationAngle 
Function 
Sets the angle of rotation about the central axis for lines, polygons and polylines. 
Syntax 
BOOL SetRotationAngle(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, long int 
IRotationAngle); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IRotationAngle 
Angle of rotation 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 

SetLeft example (Page 1565) 
SetRoundCornerHeight 
Function 


Specifies the radius of the rounded corner of a rectangle vertically. 
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Syntax 


BOOL SetRoundCornerHeight(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long 
int IRoundCornerHeight); 


Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


IRoundCornerHeight 
Vertical radius 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetHeight example (Page 1564) 
SetRoundCornerWidth 
Function 
Specifies the radius of the rounded corner of a rectangle horizontally. 
Syntax 
BOOL SetRoundCornerWidth(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long 
int IRoundCornerWidth); 
Parameters 


IpszPictureName 


Picture name 
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Return value 


See also 


SetStartAngle 


Function 


Syntax 


Parameters 


Return value 


1308 


IpszObjectName 
Object name 


IRoundCornerWidth 
Horizontal radius 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetWidth example (Page 1579) 


Sets the start angle of circle and ellipse segments and circle and elliptical arcs. 


BOOL SetStartAngle(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IStartAngle); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IStartAngle 
Starting angle 


TRUE 
The function has been completed without any errors. 
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See also 


SetTop 


Function 


Syntax 


Parameters 


Return value 


See also 


2.15 ANSI-C function descriptions 


FALSE 
An error has occurred. 


SetHeight example (Page 1564) 


Sets the Y value of the upper left corner of the rectangle framing an object. 


BOOL SetTop(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int ITop); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


ITop 
Y value of the upper left corner of the framing rectangle 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


SetTop example (Page 1578) 
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SetWidth 


Function 


Syntax 


Parameters 


Return value 


See also 


SetZeroPoint 


Function 
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Sets the width of the rectangle framing an object. 


BOOL SetWidth(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int IWidth); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


Width 
Width of the framing rectangle 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


If the function is called in relation to the entire picture, set the parameter lpszObjectName = 


NULL. 


SetWidth example (Page 1579) 


Sets the zero point for bar objects. 
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Syntax 
BOOL SetZeroPoint(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, long int 
IZeroPoint); 

Parameters 
lpszPictureName 


Picture name 


IpszObjectName 
Object name 


IZeroPoint 
Zero point 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetTop example (Page 1578) 


i_o - short description 


The various properties affecting input and output values can be modified or called in using the 
functions in the i_o group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 
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SetAssumeOnExit 


Function 


Specifies for I/O fields whether the entered value is assumed upon exiting the field. 


Syntax 
BOOL SetAssumeOnExit(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, BOOL 
bAssumeOnExit); 

Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bAssumeOnExit 
Value application upon exiting the field yes/no 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetHiddenInput example (Page 1564) 
SetAssumeOnFull 
Function 
Specifies for I/O fields whether the entered value is assumed on completion of input. 
Syntax 


BOOL SetAssumeOnFull(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, BOOL 
bAssumeOnFull); 
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Parameters 


Return value 


See also 


SetBitNumber 


Function 


Syntax 


Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


bAssumeOnFull 


Value application on completion of input yes/no 


TRUE 


2.15 ANSI-C function descriptions 


The function has been completed without any errors. 


FALSE 


An error has occurred. 


SetHiddenInput example (Page 1564) 


Sets the relevant bit in the output value for the "bit" list type. 


BOOL SetBitNumber(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, long int 


IBitNumber); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IBitNumber 


Relevant bit in the output value for the "bit" list type 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


1313 


ANSI-C for Creating Functions and Actions 
2.15 ANSI-C function descriptions 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
List types (Page 1596) 
SetClearOnError 
Function 
Specifies for I/O fields whether deletion of the content in case of input errors is activated. 
Syntax 
BOOL SetClearOnError(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, BOOL 
bClearOnError); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bClearOnError 
Deletion of the entry in case of input errors yes/no 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
SetHiddenInput example (Page 1564) 
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SetClearOnNew 


Function 


Syntax 


Parameters 


Return value 


See also 


SetHiddenInput 


Function 


Syntax 


2.15 ANSI-C function descriptions 


Specifies the deletion of the content in case of new inputs for I/O fields. 


BOOL SetClearOnNew(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, BOOL 
bClearOnNew); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bClearOnNew 
Deletion of content in case of new input yes/no 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


SetHiddenInput example (Page 1564) 


Controls the hidden input for I/O fields. 


BOOL SetHiddenInput(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, BOOL 
bHiddenInput); 
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Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bHiddenInput 
Hidden input yes/no 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
SetHiddenInput example (Page 1564) 
SetNumberLines 
Function 
Sets the number of visible lines lines for the "text list" object. 
Syntax 
BOOL SetNumberLines(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
INumberLines); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


INumberLines 
Number of visible lines 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


If the amount of configured text is larger than the number of visible lines, the "text list" object 
receives a vertical scroll bar. 


SetOutputValueChar 


Function 


Sets a pointer to the output value for I/O fields 


Syntax 
BOOL SetOutputValueChar(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, char* 
szOutputValueChar); 

Parameters 
lpszPictureName 


Picture name 


IpszObjectName 
Object name 


szOutputValueChar 
Pointer to the output value 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 
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SetOutputValueDouble 


Function 


Syntax 


Parameters 


Return value 


See also 


1318 


Sets the output value for I/O fields. 


BOOL SetOutputValueDouble(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, 


double dOutputValueDouble); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


dOutputValueDouble 
Output value 


TRUE 


The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetOutputValueDouble example (Page 1566) 
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Limits - short description 


SetAlarmHigh 


Function 


Syntax 


Parameters 


Return value 


The various properties affecting limit values can be modified or called in using the functions 
in the Limits group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


Sets the upper alarm limit for bar objects. 


BOOL SetAlarmHigh(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, double 
dAlarmHigh); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


dAlarmHigh 
Upper alarm limit 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 
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See also 
SetAlarmHigh example (Page 1559) 
SetAlarmLow 
Function 
Sets the lower alarm limit for bar objects. 
Syntax 
BOOL SetAlarmLow(LPCTSTR lIpszPictureName, LPCTSTR lpszObjectName, double 
dAlarmLow); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


dAlarmLow 


Lower alarm limit 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 

SetAlarmHigh example (Page 1559) 
SetCheckAlarmHigh 
Function 


Controls the monitoring of the upper alarm limit for bar objects. 
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Syntax 
BOOL SetCheckAlarmHigh(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, BOOL 
bCheckAlarmHigh); 

Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bCheckAlarmHigh 
Monitoring yes/no 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetMarker example (Page 1566) 
SetCheckAlarmLow 
Function 
Controls the monitoring of the lower alarm limit for bar objects. 
Syntax 
BOOL SetCheckAlarmLow(LPCTSTR IpszPictureName, LPCTSTR lIpszObjectName, BOOL 
bCheckAlarmLow); 
Parameters 
IpszPictureName 


Picture name 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 1321 


ANSI-C for Creating Functions and Actions 


2.15 ANSI-C function descriptions 


Return value 


IpszObjectName 
Object name 


bCheckAlarmLow 
Monitoring yes/no 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetMarker example (Page 1566) 
SetCheckLimitHigh4 
Function 
Controls the monitoring of the upper limit value reserve 4 for bar objects. 
Syntax 
BOOL SetCheckLimitHigh4(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, BOOL 
bCheckLimitHigh4); 
Parameters 
IpszPictureName 


Return value 


1322 


Picture name 


IpszObjectName 
Object name 


bCheckLimitHigh4 
Monitoring yes/no 


TRUE 
The function has been completed without any errors. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


ANSI-C for Creating Functions and Actions 


FALSE 


An error has occurred. 


2.15 ANSI-C function descriptions 


See also 
SetMarker example (Page 1566) 
SetCheckLimitHigh5 
Function 
Controls the monitoring of the upper limit value reserve 5 for bar objects. 
Syntax 
BOOL SetCheckLimitHigh5(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, BOOL 
bCheckLimitHigh5); 
Parameters 
IpszPictureName 


Return value 


See also 


Picture name 


IpszObjectName 
Object name 


bCheckLimitHigh5 
Monitoring yes/no 


TRUE 


The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetMarker example (Page 1566) 
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SetCheckLimitLow4 


Function 


Controls the monitoring of the lower limit value reserve 4 for bar objects. 


Syntax 
BOOL SetCheckLimitLow4(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, BOOL 
bCheckLimitLow4); 

Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bCheckLimitLow4 
Monitoring yes/no. 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetMarker example (Page 1566) 
SetCheckLimitLow5 
Function 
Controls the monitoring of the lower limit value reserve 5 for bar objects. 
Syntax 


BOOL SetCheckLimitLow5(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, BOOL 
bCheckLimitLow5); 
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Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


bCheckLimitLow5 
Monitoring yes/no 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetMarker example (Page 1566) 
SetCheckToleranceHigh 
Function 
Controls the monitoring of the upper tolerance limit for bar objects. 
Syntax 
BOOL SetCheckToleranceHigh(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, 
BOOL bCheckToleranceHigh); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bCheckToleranceHigh 
Monitoring yes/no 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
SetMarker example (Page 1566) 
SetCheckToleranceLow 
Function 
Controls the monitoring of the lower tolerance limit for bar objects. 
Syntax 
BOOL SetCheckToleranceLow(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, 
BOOL bCheckToleranceLow); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bCheckToleranceLow 
Monitoring yes/no 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
SetMarker example (Page 1566) 
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SetCheckWarningHigh 


Function 


Controls the monitoring of the upper warning limit for bar objects. 


Syntax 


BOOL SetCheckWarningHigh(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, 
BOOL bCheckWarningHigh); 


Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bCheckWarningHigh 
Monitoring yes/no 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
SetMarker example (Page 1566) 
SetCheckWarningLow 
Function 
Controls the monitoring of the lower warning limit for bar objects. 
Syntax 


BOOL SetCheckWarningLow(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, 
BOOL bCheckWarningLow); 
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Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


bCheckWarningLow 
Monitoring yes/no 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
SetMarker example (Page 1566) 
SetColorAlarmHigh 
Function 
Sets the bar color for bar objects upon reaching the upper alarm limit. 
Syntax 
BOOL SetColorAlarmHigh(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, long int 
IColorAlarmHigh); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IColorAlarmHigh 
Numeric value defining the bar color 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
SetColorAlarmLow 
Function 
Sets the bar color for bar objects upon reaching the lower alarm limit. 
Syntax 
BOOL SetColorAlarmLow(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, long int 
IColorAlarmLow); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IColorAlarmLow 
Numeric value defining the bar color 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 
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See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
SetColorLimitHigh4 
Function 
Sets the bar color for bar objects upon reaching the upper limit reserve 4. 
Syntax 
BOOL SetColorLimitHigh4(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IColorLimitHigh4); 
Parameters 
IpszPictureName 


Return value 


See also 


1330 


Picture name 


IpszObjectName 
Object name 


IColorLimitHigh4 
Numeric value defining the bar color 


TRUE 


The function has been completed without any errors. 


FALSE 


An error has occurred. 


Color chart (Page 1592) 
SetBackColor example (Page 1559) 
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SetColorLimitHigh5 


Function 


Sets the bar color for bar objects upon reaching the upper limit reserve 5. 


Syntax 
BOOL SetColorLimitHigh5(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IColorLimitHigh5); 

Parameters 
lpszPictureName 


Picture name 


IpszObjectName 
Object name 


IColorLimitHigh5 
Numeric value defining the bar color 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
SetColorLimitLow4 
Function 
Sets the bar color for bar objects upon reaching the lower limit reserve 4. 
Syntax 


BOOL SetColorLimitLow4(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IColorLimitLow4); 
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Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IColorLimitLow4 


Numeric value defining the bar color 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
SetColorLimitLow5 
Function 
Sets the bar color for bar objects upon reaching the lower limit reserve 5. 
Syntax 
BOOL SetColorLimitLow5(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IColorLimitLow5); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IColorLimitLow5 


Numeric value defining the bar color 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
SetColorToleranceHigh 
Function 
Sets the bar color for bar objects upon reaching the upper tolerance limit. 
Syntax 
BOOL SetColorToleranceHigh(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long 
int IColorToleranceHigh); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IColorToleranceHigh 
Numeric value defining the bar color 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 
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See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
SetColorToleranceLow 
Function 
Sets the bar color for bar objects upon reaching the lower tolerance limit. 
Syntax 
BOOL SetColorToleranceLow(LPCTSTR lpszPictureName, LPCTSTR IlpszObjectName, long 
int IColorToleranceLow); 
Parameters 


Return value 


See also 


1334 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IColorToleranceLow 
Numeric value defining the bar color 


TRUE 


The function has been completed without any errors. 


FALSE 


An error has occurred. 


Color chart (Page 1592) 
SetBackColor example (Page 1559) 
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SetColorWarningHigh 


Function 


Sets the bar color for bar objects upon reaching the upper warning limit. 


Syntax 


BOOL SetColorWarningHigh(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, long 
int IColorWarningHigh); 


Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IColorWarningHigh 
Numeric value defining the bar color 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 


SetColorWarningLow 


Function 


Sets the bar color for bar objects upon reaching the lower warning limit. 


Syntax 


BOOL SetColorWarningLow(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long 
int IColorWarningLow); 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 1335 


ANSI-C for Creating Functions and Actions 


2.15 ANSI-C function descriptions 


Parameters 


Return value 


See also 


SetLimitHigh4 


Function 


Syntax 


Parameters 
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IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IColorWarningLow 
Numeric value defining the bar color 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Color chart (Page 1592) 
SetBackColor example (Page 1559) 


Sets the high limit value for reserve 4 for bar objects. 


BOOL SetLimitHigh4(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, double 
dLimitHigh4); 


IpszPictureName 


Picture name 


IpszObjectName 

Object name 

dLimitHigh4 

High limit value for reserve 4 
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Return value 


See also 


SetLimitHigh5 


Function 


Syntax 


Parameters 


Return value 


See also 


2.15 ANSI-C function descriptions 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


SetAlarmHigh example (Page 1559) 


Sets the high limit value for reserve 5 for bar objects. 


BOOL SetLimitHigh5(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, double 
dLimitHigh5); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


dLimitHigh5 
High limit value for reserve 5 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


SetAlarmHigh example (Page 1559) 
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SetLimitLow4 
Function 
Sets the low limit value for reserve 4 for bar objects. 
Syntax 
BOOL SetLimitLow4(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, double 
dLimitLow4); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


dLimitLow4 


Low limit value for reserve 4 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 

SetAlarmHigh example (Page 1559) 
SetLimitLow5 
Function 

Sets the low limit value for reserve 5 for bar objects. 
Syntax 


BOOL SetLimitLow5(LPCTSTR lIpszPictureName, LPCTSTR IpszObjectName, double 
dLimitLow5); 
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Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


dLimitLow5 


Low limit value for reserve 5 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetAlarmHigh example (Page 1559) 
SetLimitMax 
Function 
Sets the high limit value for I/O fields. 
Syntax 
BOOL SetLimitMax(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, double 
dLimitMax); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


dLimitMax 
High limit value 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
SetAlarmHigh example (Page 1559) 
SetLimitMin 
Function 
Sets the low limit value for I/O fields. 
Syntax 
BOOL SetLimitMin(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, double 
dLimitMin); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


dLimitMin 


Lower limit 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
SetAlarmHigh example (Page 1559) 
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SetMarker 


Function 


Syntax 


Parameters 


Return value 


2.15 ANSI-C function descriptions 


Controls the limit marker display for bar objects. 


BOOL SetMarker(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, BOOL bMarker); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bMarker 
Limit marker on/off 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 

SetMarker example (Page 1566) 
SetToleranceHigh 
Function 

Sets the upper tolerance limit for bar objects. 
Syntax 


BOOL SetToleranceHigh(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, double 
dToleranceHigh); 
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Parameters 


Return value 


lpszPictureName 
Picture name 


IpszObjectName 
Object name 


dToleranceHigh 
Upper tolerance limit 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetAlarmHigh example (Page 1559) 
SetToleranceLow 
Function 
Sets the lower tolerance limit for bar objects. 
Syntax 
BOOL SetToleranceLow(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, double 
dToleranceLow); 
Parameters 
IpszPictureName 
Picture name 
IpszObjectName 
Object name 
dToleranceLow 
Lower tolerance limit 
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Return value 


TRUE 


The function has been completed without any errors. 


FALSE 
An error has occurred. 


2.15 ANSI-C function descriptions 


Specifies for bar objects whether the upper alarm limit is given in percentages or absolute 


BOOL SetTypeAlarmHigh(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, BOOL 


See also 
SetAlarmHigh example (Page 1559) 
SetTypeAlarmHigh 
Function 
terms. 
Syntax 
bTypeAlarmHigh); 
Parameters 
IpszPictureName 


Return value 


Picture name 


IpszObjectName 
Object name 


bTypeAlarmHigh 
Upper alarm limit 


TRUE — Specification in percent 
FALSE Absolute specification 


TRUE 


The function has been completed without any errors. 


FALSE 
An error has occurred. 
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Specifies for bar objects whether the lower alarm limit is given in percentages or absolute terms. 


BOOL SetTypeAlarmLow(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, BOOL 


See also 
SetMarker example (Page 1566) 
SetTypeAlarmLow 
Function 
Syntax 
bTypeAlarmLow); 
Parameters 
IpszPictureName 


Return value 


See also 


1344 


Picture name 


IpszObjectName 
Object name 


bTypeAlarmLow 


Lower alarm limit 


TRUE — Specification in percent 
FALSE Absolute specification 


TRUE 


The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetMarker example (Page 1566) 
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SetTypeLimitHigh4 


Function 


Specifies for bar objects whether the upper limit for reserve 4 is given in percentages or 
absolute terms. 


Syntax 
BOOL SetTypeLimitHigh4(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, BOOL 
bTypeLimitHigh4); 

Parameters 
lpszPictureName 


Picture name 


IpszObjectName 
Object name 


bTypeLimitHigh4 
High limit 


TRUE — Specification in percent 
FALSE Absolute specification 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 

SetMarker example (Page 1566) 
SetTypeLimitHigh5 
Function 


Specifies for bar objects whether the upper limit for reserve 5 is given in percentages or 
absolute terms. 
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Syntax 
BOOL SetTypeLimitHighS(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, BOOL 
bTypeLimitHigh5); 

Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bTypeLimitHigh5 
High limit 


TRUE — Specification in percent 
FALSE Absolute specification 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetMarker example (Page 1566) 

SetTypeLimitLow4 

Function 
Specifies for bar objects whether the lower limit for reserve 4 is given in percentages or absolute 
terms. 

Syntax 


BOOL SetTypeLimitLow4(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, BOOL 
bTypeLimitLow4); 
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Parameters 


Return value 


lpszPictureName 
Picture name 


IpszObjectName 
Object name 


bTypeLimitLow4 


Low limit 


TRUE — Specification in percent 
FALSE Absolute specification 


TRUE 


The function has been completed without any errors. 


FALSE 
An error has occurred. 


2.15 ANSI-C function descriptions 


Specifies for bar objects whether the lower limit for reserve 5 is given in percentages or absolute 


BOOL SetTypeLimitLow5(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, BOOL 


See also 
SetMarker example (Page 1566) 
SetTypeLimitLow5 
Function 
terms. 
Syntax 
bTypeLimitLow5); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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bTypeLimitLow5 
Low limit 


TRUE — Specification in percent 
FALSE Absolute specification 


Return value 


TRUE 


The function has been completed without any errors. 


FALSE 


An error has occurred. 


Specifies for bar objects whether the high tolerance limit is given in percentages or absolute 


BOOL SetTypeToleranceHigh(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, 


See also 
SetMarker example (Page 1566) 
SetTypeToleranceHigh 
Function 
terms. 
Syntax 
BOOL bTypeToleranceHigh); 
Parameter 
IpszPictureName 
Picture name 
IpszObjectName 
Object name 
bTypeToleranceHigh 
High tolerance limit 
TRUE — Specification in percent 
FALSE Absolute specification 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetMarker example (Page 1566) 

SetTypeToleranceLow 

Function 
Specifies for bar objects whether the lower tolerance limit is given in percentages or absolute 
terms. 

Syntax 
BOOL SetTypeToleranceLow(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, 
BOOL bTypeToleranceLow); 

Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bTypeToleranceLow 


Lower tolerance limit 


TRUE — Specification in percent 
FALSE Absolute specification 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 
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Specifies for bar objects whether the upper warning limit is given in percentages or absolute 


BOOL SetTypeWarningHigh(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, BOOL 


See also 

SetMarker example (Page 1566) 
SetTypeWarningHigh 
Function 

terms. 
Syntax 

bTypeWarningHigh); 
Parameters 


Return value 


See also 
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lpszPictureName 


Picture name 


IpszObjectName 
Object name 


bTypeWarningHigh 
Upper warning limit 


TRUE — Specification in percent 
FALSE Absolute specification 


TRUE 


The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetMarker example (Page 1566) 
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SetTypeWarningLow 


Function 


Specifies for bar objects whether the lower warning limit is given in percentages or absolute 
terms. 


Syntax 


BOOL SetTypeWarningLow(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, BOOL 
bTypeWarningLow); 


Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bTypeWarningLow 


Lower warning limit 


TRUE — Specification in percent 
FALSE Absolute specification 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetMarker example (Page 1566) 


SetWarningHigh 


Function 


Sets the upper warning limit for bar objects. 
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Syntax 


Parameters 


Return value 


See also 


SetWarningLow 


Function 


Syntax 


Parameters 
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BOOL SetWarningHigh(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, double 
dWarningHigh); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


dWarningHigh 
Upper warning limit 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetMarker example (Page 1566) 


Sets the lower warning limit for bar objects. 


BOOL SetWarningLow(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, double 
dWarningLow); 


IpszPictureName 


Picture name 
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Return value 


See also 


link 


2.15 ANSI-C function descriptions 


IpszObjectName 
Object name 


dWarningLow 


Lower warning limit 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetMarker example (Page 1566) 


Link - short description 


SetLink 


Function 


Syntax 


A tag link property can be created or called in using the functions in the Link group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


Creating a tag connection of object properties 


BOOL SetLink(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, LPCTSTR 
lpszPropertyName, LPLINKINFO *pLink); 
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Parameters 


Return value 


See also 


miscs 


IpszPictureName 
Picture name 


IpszObjectName 
Object name 


IpszPropertyName 
Name of the object property 


pLink 
Pointer to a structure of the type: LINKINFO 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Structure definition LINKINFO (Page 1605) 
SetLink example (Page 1565) 


Miscs - short description 


SetAverage 


Function 
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The properties of objects can be modified or called in using the functions in the Miscs group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


Controls the averaging of bar objects. 
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Syntax 


Parameters 


Return value 


See also 


SetBoxType 


Function 


Syntax 


Parameters 


2.15 ANSI-C function descriptions 


BOOL SetAverage(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, BOOL 
bAverage); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bAverage 
Averaging yes/no 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetVisible example (Page 1578) 


Specifies the field type (input field, output field, input/output field) for an I/O object. 


BOOL SetBoxType(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IBoxType); 


IpszPictureName 


Picture name 
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Return value 


IpszObjectName 
Object name 


IBoxType 
Field type 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
I/O field, field type (Page 1592) 
SetColorChangeType 
Function 
When using bar objects, it defines whether the color change upon reaching a limit value only 
affects a bar segment or the entire bar. 
Syntax 
BOOL SetColorChangeType(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, 
BOOL bColorChangeType); 
Parameter 
IpszPictureName 
Picture name 
IpszObjectName 
Object name 
bColorChangeType 
Type of color change 
TRUE Color change applies to a segment 
FALSE Color change applies to the entire bar 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetVisible example (Page 1578) 
SetCursorControl 
Function 
Sets the cursor control for I/O fields. 
Syntax 
BOOL SetCursorControl(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, BOOL 
bCursorControl); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bCursorControl 
Cursor control on/off 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 
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See also 
SetVisible example (Page 1578) 
SetCursorMode 
Function 
Sets the cursor control for pictures. 
Syntax 
BOOL SetCursorMode(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, BOOL 
bCursorMode); 
Parameters 
lpszPictureName 


Picture name 


IpszObjectName 
Object name 


bCursorMode 
Cursor Mode 


TRUE _ Tab order cursor 
FALSE Alpha-Cursor 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
Example - SetCursorMode (Page 1561) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
1358 System Manual, 02/2016, A5E37536061-AA 


ANSI-C for Creating Functions and Actions 
2.15 ANSI-C function descriptions 


SetEditAtOnce 
Function 
Specifies whether the "Immediate input" property is activated for I/O fields. 
Syntax 
BOOL SetEditAtOnce(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, BOOL 
bEditAtOnce); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bEditAtOnce 
Immediate input yes/no 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
SetVisible example (Page 1578) 
SetExtendedOperation 
Function 
Controls the "Extended operation" property of slider objects. 
Syntax 


BOOL SetExtendedOperation(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, 
BOOL bExtendedOperation); 
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Parameters 


Return value 


See also 


SetHysteresis 


Function 


Syntax 


Parameters 
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lpszPictureName 


Picture name 


IpszObjectName 
Object name 


bExtendedOperation 
Extended operation yes/no 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


SetVisible example (Page 1578) 


When using bar objects, it specifies whether the display appears with or without hysteresis. 


BOOL SetHysteresis(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, BOOL 
bHysteresis); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bHysteresis 
Display with/without hysteresis 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetVisible example (Page 1578) 
SetHysteresisRange 
Function 
Sets the hysteresis value in the display for bar objects. 
Syntax 
BOOL SetHysteresisRange(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, double 
dHysteresisRange); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


dHysteresisRange 
Hysteresis value 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 
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SetMax 


Function 


Syntax 


Parameters 


Return value 


SetMin 


Function 


Syntax 


Parameters 
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Sets the maximum value for bar and slider objects. 


BOOL SetMax(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, double dMax); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


dMax 


Maximum value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Sets the minimum value for bar and slider objects. 


BOOL SetMin(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, double dMin); 


IpszPictureName 


Picture name 
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Return value 


SetOffsetLeft 


Function 


Syntax 


Parameters 


Return value 


IpszObjectName 
Object name 


dMin 


Minimum value 


TRUE 


2.15 ANSI-C function descriptions 


The function has been completed without any errors. 


FALSE 


An error has occurred. 


Sets the horizontal picture distance from the left window border for picture windows. 


BOOL SetOffsetLeft(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, long int 


lOffsetLeft); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


lOffsetLeft 
Picture distance 


TRUE 


The function has been completed without any errors. 


FALSE 


An error has occurred. 
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SetOffsetTop 
Function 
Sets the vertical picture distance from the upper window border for picture windows. 
Syntax 
BOOL SetOffsetTop(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
lOffsetT op); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


lOffsetTop 
Picture distance 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetOperation 


Function 


Controls the operability of the objects. 


Syntax 


BOOL SetOperation(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, BOOL 
bOperation); 
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Parameters 


Return value 
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lpszPictureName 
Picture name 


IpszObjectName 
Object name 


bOperation 
Object operable, yes/no 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


If the function is called for the picture object, set the parameter IpszObjectName = NULL. 


See also 
SetVisible example (Page 1578) 

SetOperationMessage 

Function 
Controls the output of a message when operating the objects "I/O field", "Check box", "Radio 
box" and "Slider". 

Syntax 
BOOL SetOperationMessage(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, 
BOOL bOperationMessage); 

Parameters 


IpszPictureName 
Picture name 
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IpszObjectName 
Object name 


bOperationMessage 
Message output for yes/no operation 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetVisible example (Page 1578) 

SetOperationReport 

Function 
Controls the logging of the operating reason for all objects except application and picture 
windows and OLE control. 

Syntax 
BOOL SetOperationReport(L_PCTSTR IpszPictureName, LPCTSTR IpszObjectName, BOOL 
bOperationReport); 

Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bOperationReport 
Logging operating reason yes/no 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


If the function is called for the picture object, set the parameter lpszObjectName = NULL. 


See also 
SetVisible example (Page 1578) 

SetPasswordLevel 

Function 
Defines the authorization level for operating objects for all objects except application and 
picture windows and OLE control. 

Syntax 
BOOL SetPasswordLevel(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, long int 
IPasswordLevel); 

Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IPasswordLevel 
Authorization level 


Return value 


TRUE 
The function has been completed without any errors. 
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SetPictureName 


Function 


Syntax 


Parameters 


Return value 


See also 


1368 


FALSE 
An error has occurred. 


Note 


If the function is called in relation to the entire picture, set the parameter lpszObjectName = 


NULL. 


Sets the name of the picture, which should be shown in a picture window or in a graphic object. 


BOOL SetPictureName(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, char* 


szPictureName); 


IpszPictureName 


Picture name 


IpszObjectName 
Name of the picture window or graphic object 


szPictureName 
Pointer to the picture name 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetPictureName example (Page 1567) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


ANSI-C for Creating Functions and Actions 


SetProcess 


Function 


Syntax 


Parameters 


Return value 


SetSmallChange 


Function 


Syntax 


2.15 ANSI-C function descriptions 


Specifies the default setting of the value to be displayed for bar and slider objects. 


Sets the selected fields for check boxes and radio boxes. 


BOOL SetProcess(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, double 
dProcess); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


dProcess 


e Incase of bar and slider objects, this value is used in Runtime when the associated tag 
cannot be connected or updated when a picture is started. 


e@ For check boxes and radio boxes the selected fields are specified. In the 32-bit word each 
field is represented by a bit (field 1 corrsponds to the bit value 0). Selected fields are marked 
by a set bit. Non-existing are assigned 0. 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Sets the number of steps for slider objects by which the slider is shifted by a mouse click. 


BOOL SetSmallChange(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, long int 
ISmallChange); 
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Parameters 


Return value 


SetTagPrefix 


Function 


Syntax 


Parameters 


1370 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


ISmallChange 
Number of setting steps 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


This function sets the tag prefix of a picture window: 


In a picture window the "temperature" tag is requested on an object. If a "Motor1." tag prefix 
is assigned to the picture window, the tag "Motor1.Temperature" is requested. 


The setting of the tag prefix only becomes effective when newly supplying the picture name. 


This means you must either set the prefix before picture selection or newly supply the picture 
name if the picture is not changed. 


BOOL SetTagPrefix(LPCTSTR IpszPictureName, LPCTSTR lIpszObjectName,char* 
szTagPrefix); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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Return value 


See also 


SetTrend 


Function 


Syntax 


Parameters 


2.15 ANSI-C function descriptions 


szTagPrefix 
Tag prefix to be set 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


If the tag prefix is set for a picture window, the tag prefix is added to all tags contained in the 
picture to be displayed. This also applies if the request takes place in a function. If a tag needs 
to be read without the tag prefix, you must add "@NOTP::" to the tag name. 


Using a tag prefix greatly simplifies the picture module technology. 


SetTagPrefix example (Page 1574) 


Controls the trend display for bar objects. 


BOOL SetTrend(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, BOOL bTrend); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bTrend 
Trend display yes/no 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
SetVisible example (Page 1578) 
SetVisible 
Function 
Controls the display of an object. 
Syntax 
BOOL SetVisible(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, BOOL bVisible); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bVisible 
Object display yes/no 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


If the function is called in relation to the entire picture, set the parameter lpszObjectName = 
NULL. 
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See also 
SetVisible example (Page 1578) 


SetZeroPointValue 


Function 
Sets the absolute value of the zero point for bar objects. 
Syntax 
BOOL SetZeroPointValue(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, double 
dZeroPointValue); 
Parameters 
lpszPictureName 


Picture name 


IpszObjectName 
Object name 


dZeroPointValue 
Absolute value of the zero point 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetZoom 


Function 


Sets the scaling factor for a picture window. 


Syntax 
BOOL SetZoom(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int IZoom); 
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Parameters 


Return value 


ole_control 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


IZoom 
Scaling factor 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


OLE_control - short description 


SetPosition 


Function 


Syntax 


1374 


The functions in the ole_Control group can only be used with OCX slider objects. 


Various OCX slider object properties and settings can be modified or called in using these 
functions. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


Sets the slider position of the OCX slider object. 


BOOL SetPosition(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
Position); 
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Parameters 


Return value 


See also 


SetRangeMax 


Function 


Syntax 


Parameters 


2.15 ANSI-C function descriptions 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


[Position 
Slider position of the OCX slider object 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetPosition example (Page 1568) 


Defines the adjustment range "Max" of the OCX slider object. 


BOOL SetRangeMax(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, long int 
IRangeMax); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IRangeMax 
Adjustment range "Max" of the OCX slider object 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
SetRangeMax example (Page 1569) 
SetRangeMin 
Function 
Defines the adjustment range "Min" of the OCX slider object. 
Syntax 
BOOL SetRangeMin(LPCTSTR lIpszPictureName, LPCTSTR IpszObjectName, long int 
IRangeMin); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IRangeMin 
Adjustment range "Min" of the OCX slider object 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
SetRangeMin example (Page 1569) 
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pictures 


Pictures - short description 


Various properties of pictures of graphic objects and round buttons can be modified or called 
in using the functions in the Pictures group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


SetPicDeactTransparent 


Function 
Sets the transparent color for the "deactivated" status of a round button. 

Syntax 
BOOL SetPicDeactTransparent(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, 
long int IPicDeactTransparent); 

Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IPicDeactTransparent 
Transparent color for "deactivated" status 


Return value 


TRUE 
The function has been completed without any errors. 
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FALSE 
An error has occurred. 


Note 
This function only applies to Bitmap graphics (*.bmp). 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 


SetPicDeactUseTransColor 


Function 
Controls the transparent color for the "deactivated" status of a round button. 

Syntax 
BOOL SetPicDeactUseTransColor(LPCTSTR IpszPictureName, LPCTSTR IlpszObjectName, 
BOOL bPicDeactUseTransColor); 

Parameter 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bPicDeactUseTransColor 
Transparent color yes/no 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 
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SetPicDownTransparent 


Function 


Sets the transparent color for the "On/pressed" status of a round button. 


Syntax 


BOOL SetPicDownTransparent(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, 
long int IPicDownTransparent); 


Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IPicDownTransparent 
Transparent color for "On/pressed" status 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 
This function only applies to Bitmap graphics (*.bmp). 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 


SetPicDownUseTransColor 


Function 


Controls the transparent color for the "On/pressed" status of a round button. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 1379 


ANSI-C for Creating Functions and Actions 


2.15 ANSI-C function descriptions 


Syntax 


Parameters 


Return value 


BOOL SetPicDownUseTransColor(LPCTSTR lpszPictureName, LPCTSTR IlpszObjectName, 
BOOL bPicDownUseTransColor); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bPicDownUseTransColor 


Transparent color yes/no 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetPicTransColor 


Function 


Syntax 


Parameters 


1380 


Sets the transparent color of the background picture of a graphic object. 


BOOL SetPicTransColor(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IPicTransColor); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IPicTransColor 
Transparent color of the background picture 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 
This function only applies to Bitmap graphics (*.bmp). 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
SetPictureDeactivated 
Function 
Specifies the picture name for the "deactivated" status of a round button. 
Syntax 
BOOL SetPictureDeactivated(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, char* 
szPictureDeactivated); 
Parameters 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


szPictureDeactivated 
Picture name for "deactivated" status 


Return value 


TRUE 
The function has been completed without any errors. 
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FALSE 
An error has occurred. 


Note 


Bitmap files (*.omp, *.dib) as well as metafiles (*.emf, *.wmf) can be integrated. 


See also 
SetPictureDown example (Page 1567) 
SetPictureDown 
Function 
Specifies the picture name for the "On/pressed" status of a round button. 
Syntax 
BOOL SetPictureDown(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, char* 
szPictureDown); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


szPictureDown 
Picture name for "On/pressed" status 


Return value 


TRUE 


The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


Bitmap files (*.bmp, *.dib) as well as metafiles (*.emf, *.wmf) can be integrated. 
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See also 
SetPictureDown example (Page 1567) 
SetPictureUp 
Function 
Specifies the picture name for the "Off/not pressed" status of a round button. 
Syntax 
BOOL SetPictureUp(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, char* 
szPictureUp); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


szPictureUp 
Picture name for "Off/not pressed" status 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


Bitmap files (*.omp, *.dib) as well as metafiles (*.emf, *.wmf) can be integrated. 


See also 
SetPictureUp example (Page 1567) 
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SetPicUpTransparent 


Function 


Sets the transparent color for the "Off/not pressed" status of a round button. 


Syntax 


BOOL SetPicUpTransparent(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long 
int IPicUpTransparent); 


Parameters 


IpszPictureName 
Picture name 


IpszObjectName 
Object name 


IPicUpTransparent 
Transparent color for "Off/not pressed" status 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 
This function only applies to Bitmap graphics (*.bmp). 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 
SetPicUpUseTransColor 
Function 


Controls the transparent color for the "Off/not pressed" status of a round button. 
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Syntax 


BOOL SetPicUpUseTransColor(LPCTSTR lpszPictureName, LPCTSTR IlpszObjectName, 
BOOL bPicUpUseTransColor); 


Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bPicUpUseTransColor 
Transparent color yes/no 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetPicUseTransColor 


Function 
Controls the transparent color of the background picture of a graphic object. 


Syntax 
BOOL SetPicUseTransColor(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, 
BOOL bPicUseTransColor); 

Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bPicUseTransColor 
Transparent color yes/no 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


property 


Property - short description 


The properties of objects for which there are no direct functions can be modified or called in 
using the functions in the Property group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


SetPropBOOL 

Function 
Sets a property with the value "bValue". 

Syntax 
BOOL SetPropBOOL(LPCTSTR lIpszPictureName, LPCTSTR IpszObjectName, LPCTSTR 
lpszPropertyName, BOOL bValue) 

Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IpszPropertyName 
Name of the object property 


bValue 
Value in BOOL data format 
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Return value 


See also 


SetPropChar 


Function 


Syntax 


Parameters 


Return value 
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TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


If the function is called for the picture object, set the parameter lpszObjectName = NULL. 


SetPropBOOL example (Page 1568) 


Sets a property with the value the pointer "szValue" points to. 


BOOL SetPropChar(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, LPCTSTR 
lpszPropertyName, char* szValue) 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IpszPropertyName 
Name of the object property 


szValue 
Pointer to the value 


TRUE 
The function has been completed without any errors. 
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FALSE 
An error has occurred. 


Note 


If the function is called for the picture object, set the parameter IlpszObjectName = NULL. 


See also 
GetPropChar example (Page 1534) 
SetPropDouble 
Function 
Sets a property with the value "dValue". 
Syntax 
BOOL SetPropDouble(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, LPCTSTR 
lpszPropertyName, double dValue) 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IpszPropertyName 
Name of the object property 


dValue 
Value in "double" data format 


Return value 


TRUE 
The function has been completed without any errors. 
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FALSE 
An error has occurred. 


Note 


If the function is called for the picture object, set the parameter IlpszObjectName = NULL. 


SetPropWord 

Function 
Sets a property with the value "IValue". 

Syntax 
BOOL SetPropWord(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, LPCTSTR 
lpszPropertyName, long Value) 

Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IpszPropertyName 
Name of the object property 


Value 
Value in "long" data format 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Note 


If the function is called for the picture object, set the parameter IpszObjectName = NULL. 
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state 


State - short description 


The properties of status displays can be modified or called in using the functions in the State 
group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


SetBasePicTransColor 


Function 
Sets the transparent color of the basic picture for the status display. 

Syntax 
BOOL SetBasePicTransColor(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, long 
int IBasePicTransColor); 

Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IBasePicTransColor 
Transparent color of the basic picture 


Return value 


TRUE 
The function has been completed without any errors. 
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FALSE 
An error has occurred. 


Note 
This function only applies to Bitmap graphics (*.bmp). 


See also 
Color chart (Page 1592) 
SetBackColor example (Page 1559) 


SetBasePicUseTransColor 


Function 
Controls the transparent color of the basic picture for the status display. 

Syntax 
BOOL SetBasePicUseTransColor(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, 
BOOL bBasePicUseTransColor); 

Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bBasePicUseTransColor 
Transparent color yes/no 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 
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SetFlashFlashPicture 


Function 


Specifies whether the flash picture of the status display is animated dynamically or statically. 


Syntax 
BOOL SetFlashFlashPicture(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, BOOL 
bFlashFlashPicture); 

Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bFlashFlashPicture 
Type of flash picture 


TRUE = dynamically animated flash picture 
FALSE | statically animated flash picture 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


SetFlashPicTransColor 


Function 


Sets the transparent color of the flash picture for a status display. 


Syntax 


BOOL SetFlashPicTransColor(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, long 
int IFlashPicTransColor); 
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Parameters 


Return value 


See also 


2.15 ANSI-C function descriptions 


lpszPictureName 


Picture name 


IpszObjectName 
Object name 


IFlashPicTransColor 
Transparent color of the flash picture 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 
This function only applies to Bitmap graphics (*.bmp). 


Color chart (Page 1592) 
SetBackColor example (Page 1559) 


SetFlashPicUseTransColor 


Function 


Syntax 


Parameters 


Controls the transparent color of the flash picture for a status display. 


BOOL SetFlashPicUseTransColor(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, 
BOOL bFlashPicUseTransColor); 


lpszPictureName 


Picture name 
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IpszObjectName 
Object name 


bFlashPicUseTransColor 
Transparent color yes/no 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetFlashRateFlashPic 


Function 
Sets the flash frequency of the flash picture for a status display. 


Syntax 


BOOL SetFlashRateFlashPic(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, long 
int IFlashRateFlashPic); 


Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IFlashRateFlashPic 
Flash frequency of the flash picture 


Return value 


TRUE 
The function has been completed without any errors. 
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See also 


Setindex 


Function 


Syntax 


Parameters 


Return value 


2.15 ANSI-C function descriptions 


FALSE 
An error has occurred. 


Note 


Since the flashing is performed by means of software engineering, the precise frequency is 
both system-dependent and hardware-bound (number of objects, processor speed, RAM size, 
update time etc.). 


Flash frequencies (Page 1590) 
SetFlashRateFlashPic example (Page 1563) 


Sets the index of a polygon or polyline thus defining the current object point. 


BOOL SetIlndex(LPCTSTR lpszPictureName, LPCTSTR IlpszObjectName, long int IIndex); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


lIndex 


Index value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 
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style 


Style - short description 


Various properties affecting the appearance of objects can be modified or called in using the 
functions in the Style group. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 


well. 
SetBackBorderWidth 
Function 
Sets the frame width of 3D frames and slider objects. 
Syntax 
BOOL SetBackBorderWidth(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long 
int IBackBorderWidcth); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IBackBorderWidth 


Frame width in pixels 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 
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See also 
SetBorderStyle example (Page 1560) 
SetBorderEndStyle 
Function 
Sets the type of line end. 
Syntax 
BOOL SetBorderEndStyle(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IBorderEndStyle); 
Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IBorderEndStyle 


Type of line end as numeric value 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
Line end style (Page 1595) 
SetBorderEndStyle example (Page 1559) 
SetBorderStyle 
Function 


Sets the line or border style. 
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Syntax 


Parameters 


Return value 


See also 


SetBorderWidth 


Function 


Syntax 


Parameters 


1398 


BOOL SetBorderStyle(LPCTSTR IpszPictureName, LPCTSTR IlpszObjectName, long int 


IBorderStyle); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IBorderStyle 
Numeric value defining the line or border style 


TRUE 


The function has been completed without any errors. 


FALSE 


An error has occurred. 


Line styles (Page 1595) 
SetBorderStyle example (Page 1560) 


Sets the line or border line width. 


BOOL SetBorderWidth(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 


IBorderWidth); 


IpszPictureName 


Picture name 
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IpszObjectName 
Object name 


IBorderWidth 
Line width or border line width 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
SetBorderStyle example (Page 1560) 


SetBoxAlignment 


Function 
Defines the arrangement of controls (left or right justified) in check boxes or radio boxes. 
Syntax 
BOOL SetBoxAlignment(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, long int 
IBoxAlignment); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IBoxAlignment 


Arrangement of controls 


Return value 


TRUE 
The function has been completed without any errors. 
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FALSE 
An error has occurred. 


See also 
Element alignment in check boxes and radio boxes (Page 1592) 
SetBorderStyle example (Page 1560) 

SetFillStyle 

Function 
Sets the type of fill pattern. 

Syntax 
BOOL SetFillStyle(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, long int 
IFillStyle); 

Parameters 
IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IFillStyle 
Type of fill pattern as numeric value 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Note 


If the function is called in relation to the entire picture, set the parameter lpszObjectName = 
ZERO. 
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See also 
Fill pattern (Page 1594) 
SetFillStyle example (Page 1562) 
SetFillStyle2 
Function 
Sets the bar fill pattern for a bar graph. 
Syntax 
BOOL SetFillStyle2(LPCTSTR lIpszPictureName, LPCTSTR lpszObjectName, long int 
IFillStyle2); 
Parameters 
lpszPictureName 


Picture name 


IpszObjectName 
Object name 


IFillStyle2 
Bar fill pattern as numeric value 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
Fill pattern (Page 1594) 
SetFillStyle example (Page 1562) 
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SetltemBorderStyle 


Function 


Syntax 


Parameters 


Return value 


Sets the dividing line style for the "text list" object. 


BOOL SetltemBorderStyle(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, long int 
IltemBorderStyle); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


IltemBorderStyle 
Numeric value defining the dividing line style 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
Line styles (Page 1595) 
SetBorderStyle example (Page 1560) 
SetltemBorderWidth 
Function 
Sets the dividing line width for the "text list" object. 
Syntax 
BOOL SetltemBorderWidth(LPCTSTR IpszPictureName, LPCTSTR lpszObjectName, long int 
IltemBorderWidth); 
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Parameters 


Return value 


See also 


SetPressed 


Function 


Syntax 


Parameters 
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lpszPictureName 


Picture name 


IpszObjectName 
Object name 


IltemBorderWidth 
Numeric value defining the dividing line width 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


SetBorderStyle example (Page 1560) 


Specifies for buttons or round buttons whether the switch setting is "pressed" or "not pressed". 


BOOL SetPressed(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, BOOL 
bPressed); 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 
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bPressed 
Switch setting of the button 


TRUE Switch setting "pressed" 
FALSE Switch setting "not pressed" 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


SetToggle 
Function 
Specifies for buttons or round buttons whether the switch is latchable or not. 
Syntax 
BOOL SetToggle(LPCTSTR IpszPictureName, LPCTSTR IpszObjectName, BOOL bToggle); 
Parameters 


IpszPictureName 


Picture name 


IpszObjectName 
Object name 


bToggle 
Switch latchable/not latchable 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
1404 System Manual, 02/2016, ASE37536061-AA 


ANSI-C for Creating Functions and Actions 
2.15 ANSI-C function descriptions 


SetWindowsStyle 


Function 
Specifies whether buttons are to be displayed in Windows style. 


Syntax 
BOOL SetWindowsStyle(LPCTSTR lpszPictureName, LPCTSTR IpszObjectName, BOOL 
bWindowStyle); 

Parameters 
lpszPictureName 


Picture name 


IpszObjectName 
Object name 


bWindowStyle 
"Windows style" on/off 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


OpenHomePicture 


Function 


Opens the entered start picture. 


Syntax 
BOOL OpenHomePicture(); 


Return value 


TRUE 
The function has been completed without any errors. 
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FALSE 
An error has occurred. 


OpenNextPicture 


Function 


WinCC saves the names of the pictures opened by the user during runtime as well as the 
sequence in which these pictures were opened. 


The maximum number of picture names saved this way can be set in the WinCC Explorer in 
the computer properties on the "Graphics Runtime" tab under "picture buffer size". 


The OpenNextPicture function now opens the picture which was opened before the last call 
of OpenPrevPicture. 


Syntax 
BOOL OpenNextPicture(); 


Return value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


OpenPrevPicture 


Function 


WinCC saves the names of the pictures opened by the user during runtime as well as the 
sequence in which these pictures were opened. 


The maximum number of picture names saved this way can be set in the WinCC Explorer in 
the computer properties on the "Graphics Runtime" tab under "picture buffer size". 


The OpenPrevPicture function now opens the picture which was opened before the currently 
open picture. 


Syntax 
BOOL OpenPrevPicture(); 
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TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


OpenStoredPicture 


Function 


Syntax 


Return value 


StorePicture 


Function 


Syntax 


Return value 


Opens the picture saved with the StorePicture function. 


BOOL OpenStoredPicture(); 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Saves the current picture which can then be opened with the OpenStoredPicture function. 


BOOL StorePicture(); 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 
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2.15.3.5 


tag 


tag - short description 


Tags can be set or called in using the functions from the tag group. 


GetTag or GetTagWait? 


Process tags that are called with GetTag are put in an image. Since updating and reading the 
image is done in two separate procedures, the GetTag call is not directly influenced by the 
coupling. It can therefore be executed quicker and more independently than a GetTagWait 
retrieval. 


With GetTagWait, process tags that have been requested are not accepted in the image. A 
GetTagWait retrieval reads the value explicitly from the AS. This always includes the send and 
return path through the coupling and the response time of the AS. During this runtime, the 
processing of the C actions is blocked and the time required for the retrieval cannot be 
estimated. If multiple tags are read, the time is added. 


A GetTagWait call is required if 

e fast write/read procedures are to be synchronized 

e a value is read explicitly from the AS 

e or aregistration is to be avoided in the image deliberately. 


The GetTagWait call is to be avoided in cyclic C-Actions, this is the main reason for 
performance problems. 


SetTag or SetTagWait? 


1408 


The SetTag retrieval distributes a write job without waiting for confirmation from the AS. 


The SetTagWait retrieval distributes a write job and waits for confirmation from the AS. This 
always includes the send and return path through the coupling and the response time of the 
AS. During this runtime, the processing of the C actions is blocked and the time required for 
the retrieval cannot be estimated. If multiple tags are written, the time is added. 


A SetTagWait call is set to guarantee that the value has been written before the C-Action is 
processed any further. The SetTagWait call in cyclic C actions is to be avoided. 


Note 


The difference between GetTag and GetTagWait also exists for internal tags. The difference 
is not quite so serious here however, since no coupling comes into play. To synchronize fast 
write/read procedures, the respective wait function is to be used with internal tags as well. 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 
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get 
Functionality of the GetTag functions 


GetTagxXxxX 


By calling the function the tag is logged on and, from that moment, polled cyclically from the 
AS. The cycle for the registration depends on the trigger (see following description). For 
GetTagXXxX calls, the value that is available in WinCC is sent. For Close Picture, the tag actions 
are ended again. 


The call is marked by the following: 
e The value is read from the tag image by WinCC. 


e The call is faster in comparison to GetTagxxXXWait (except for the first call which generally 
takes longer because the value from the PLC must be read out and logged on). 


e The duration of the call does not depend on the bus-load or on the AS. 


e@ The function does not deliver any information on the status of the tags 
Asynchronous 


GetIagXXxxX 
Process 


I 
l 
I 
I 
l 
I 
1 1/2 Trigger 
| ‘| MYaluet 


Note 


If a tag is requested in a Global Script action, it remains registered throughout the enter 
Runtime of WinCC. 


In Callback functions, the respective GetTagXXXWait function must be used. 


Behavior in actions with tag trigger (recommended): 


All of the tags contained in the tag trigger are already known with Open Picture and are 
registered with the defined monitoring time. 


Since all tags are requested at once, the best possible optimization can be targeted from the 
channel. If a tag is requested with GetTagXXX() within a C-Action, which is contained in the 
trigger, the value already exists and is sent directly to the call (high-performance). 


Registering tags in actions with tag trigger 
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As the tags are already known when the picture is selected, they can be transmitted in a job 
to the Data Manager and so be registered collectively to the channel. 


Script Data Manager Channel AS 
Get Tagx (Tad 3 
Send Tag1, Tag2, Tag3 all 1 sec 
Get Tage (Tag2) =$£———_______ or -_ 
(Set Tagx xx(Tags) 
Note 
If a tag is requested, which is not in the trigger, then the behavior is the same as with the default 
trigger. 


Behavior in actions with default trigger: 


tags are registered with half of the cycle time with the first call. For every other call, the value 
is present. 


Registering tags in actions with default trigger and event trigger 


Only when the individual actions are executed is it identified which tags are needed in the 
picture. As a result, the tags are registered to the channel in a large number of single jobs. 
When a picture with cyclic actions is selected, the continual reorganization may place a heavy 
strain on communications. 


Example: The channel supports custom cycle creation. Usually cycles are created by the 
channel directly from the AS. The resources for these cycles are limited by the AS. As a result, 
the channel stops the current jobs for this cycle and reconfigures the cycle on the AS. 
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Script Data Manager Channel AS 
= — . Send Taq all 1 sec 
Get Tag x (Tac i] —— so _ 
7 ee : Stop sending Taq 
Get Tagxxx(Tag2) = =———_______gae nn fe 
OK 
—« 
Send Taq1, Tag? all 1 sec 
i 
Get TagXXX(Tag3) ne Stop sending Taq, Tagq2 - 
OK 
aT} n0™—— 
Send Tag, Tag2, Tags all 1 sec 
a 
Behavior in event triggered actions: 
The tag is registered in the "upon change" mode with the first call. Process tags that are 
registered in the "upon change" mode correspond with a cyclic read job with a cycle time of 
1s. 
Note 
If a value is requested by GetTagXXX() by a mouse click for example, the tag is accepted in 
the tag image. The tag is requested cyclically from the AS as of this point in time and therefore 
increases the basic load. 
To avoid this increase in basic loading, the value can be requested by GetTagXXXWait(). The 
call GetTagXXXWait() causes a higher communication load one time but the tag is not added 
to the tag image. 
GetTagxXxXWait 


The function returns the current value. The tag is not registered cyclically, the value is 
requested from the AS one time only. 


The call is marked by the following: 
e@ The value is read explicitly from the AS. 


e The call, compared with GetTagXXX, takes longer. 
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e The duration of the call does not depend on the bus-load or on the AS. 


e The function does not deliver any information on the status of the tags. 


Synchronous 


GetlagWaitXxx 


Trigger 


GetTagXxXxState 


The function GetTagxXXXState has the same features as GetTagXXxX, it also sends the function 
information on the status of the tags. Since the status is always delivered internally, there is 
no performance difference to GetTagxxx. 


GetTagXxxStateWait 


The function GetTagXXXStateWait has the same features as GetTagXXXWait, additionally it 
sends the function information on the status of the tags. Since the status is always delivered 
internally, there is no performance difference to GetTagXXXWait. 


The difference between functions GetTagxxXXStateWait and GetTagXXXState corresponds 
with the difference between GetTagXXXWait and GetTagXXxX. Since the value is explicitly 
read from the AS for process tags, the value and the status can be more current than for 
GetTagxXXxXState. 


GetTagXxxStateQC 


The function GetTagxXXXStateQC has the same features as GetTagXXXState. The function 
also delivers information on the quality code of the tag. 


GetTagXxxStateQCWait 


The function GetTagxxXStateQCWait has the same features as GetTagxxXXStateWait. The 
function also delivers information on the quality code of the tag. 


GetTagMultiWait 


The function GetTagMultiWait has the same features as GetTagXXXWait. However, it allows 
the request for more tags in a job. Therefore, the read requests in the direction of the AS can 
be optimized in most cases so that only one request will be given to the AS. 
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GetTagMultiStateWait 


The function GetTagMultiStateWait has the same features as GetTagMultiWait, additionally it 
sends the function information on the statuses of the tags. 


GetTagMultiStateQCWait 


The function GetTagMultiStateQCWait has the same features as GetTagMultiStateWait. The 
function also delivers information on the quality codese of the tags. 


state 

wait 

getTagBitStateWait 

Function 
Determines the value of a tag of data type "Binary tag". The value is read explicitly from the 
AS. The status of the tag is also returned. 

Syntax 
BOOL GetTagBitStateWait(Tag Tag_Name, PDWORD Ip_dwstate); 

Parameters 


Return value 


See also 


Tag_Name 
name of the tag 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


Value of the tag in the data type "BOOL" 


Tag statuses (Page 1598) 
GetTagBitStateWait example (Page 1541) 
Functionality of the GetTag functions (Page 1409) 
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GetTagByteStateWait 


Function 


Syntax 


Parameters 


Return value 


Determines the value of a tag of data type "unsigned 8 bit". The value is read explicitly from 
the AS. The status of the tag is also returned. 


BYTE GetTagByteStateWait(Tag Tag_Name, PDWORD Ip_dwstate); 


Tag_Name 
name of the tag 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


Value of the tag in the data type "BYTE" 


See also 
Tag statuses (Page 1598) 
GetTagWordStateWait example (Page 1554) 
Functionality of the GetTag functions (Page 1409) 
GetTagCharStateWait 
Function 
Determines the value of a tag of data type "8-bit text tag" or "16-bit text tag". The value is read 
explicitly from the AS. The status of the tag is also returned. 
Syntax 
char* GetTagCharStateWait(Tag Tag_Name, PDWORD Ip_dwstate); 
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Parameters 


Tag_Name 
name of the tag 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


Return value 
Pointer to the value of the tag in data type "char". 


The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 

pszValue = GetText (lpszPictureName, "Text1"); 

if(pszValue != NULL) 


See also 
Functionality of the GetTag functions (Page 1409) 
Tag statuses (Page 1598) 
Beispiel GetTagCharStateWait (Page 1544) 
GetTagDoubleStateWait 
Function 
Determines the value of a tag of data type "64-bit floating point value". The value is read 
explicitly from the AS. The status of the tag is also returned. 
Syntax 
double GetTagDoubleStateWait(Tag Tag_Name, PDWORD Ip_dwstate); 
Parameters 


Tag_Name 
name of the tag 


lp_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 
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Return value 


Value of the tag in the data type "double" 


See also 
Tag statuses (Page 1598) 
GetTagFloatStateWait example (Page 1546) 
Functionality of the GetTag functions (Page 1409) 
GetTagDWordStateWait 
Function 
Determines the value of a tag of data type "unsigned 32 bit". The value is read explicitly from 
the AS. The status of the tag is also returned. 
Syntax 
DWORD GetTagDWordStateWait(Tag Tag_Name, PDWORD Ip_dwstate); 
Parameters 


Return value 


See also 


1416 


Tag_Name 
name of the tag 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


Value of the tag in the data type "DWORD" 


Tag statuses (Page 1598) 
GetTagWordStateWait example (Page 1554) 
Functionality of the GetTag functions (Page 1409) 
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GetTagFloatStateWait 


Function 


Syntax 


Parameters 


Return value 


See also 


Determines the value of a tag of data type "32-bit floating point value". The value is read 
explicitly from the AS. The status of the tag is also returned. 


float GetTagFloatStateWait(Tag Tag_Name, PDWORD Ip_dwstate); 


Tag_Name 
name of the tag 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


Value of the tag in the data type "float" 


Tag statuses (Page 1598) 
GetTagFloatStateWait example (Page 1546) 
Functionality of the GetTag functions (Page 1409) 


GetTagMultiStateWait 


Function 


Syntax 


The values and states of several tags are established and stored in the corresponding 
addresses in the specified format. The values are read explicitly from the AS. 


The function must transfer a DWORD array whose members contain the individual tag states 
after the function is invoked. The size of the array must be selected so that sufficient memory 
space is available for these statuses. 


BOOL GetTagMultiStateWait(DWORD* pdwState, const char* pFormat) 
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Parameters 


Return value 


pdwState 
Field in which the tag statuses are stored. 


pFormat 
Format description for all requested tags and for each tag name and address of the value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
Format descriptors (Page 1593) 
Tag statuses (Page 1598) 
GetTagMultiStateWait example (Page 1548) 
Functionality of the GetTag functions (Page 1409) 
GetTagRawStateWait 
Function 
Determines the value of a tag of data type "Raw data type". The value is read explicitly from 
the AS. The status of the tag is also returned. 
Syntax 
BOOL GetTagRawStateWait(Tag Tag_Name, BYTE pValue, DWORD size, PPWORD 
Ip_dwstate); 
Parameters 
Tag_Name 
name of the tag 
pValue 
The pointer to a byte field which contains the value of the raw data tag 
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size 
Size of the byte field in bytes 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
Tag statuses (Page 1598) 
GetTagRawStateWait example (Page 1551) 
Functionality of the GetTag functions (Page 1409) 
GetTagSByteStateWait 
Function 
Determines the value of a tag of data type "signed 8 bit". The value is read explicitly from the 
AS. The status of the tag is also returned. 
Syntax 
signed char GetTagSByteStateWait(Tag Tag_Name, PDWORD Ip_dwstate); 
Parameters 


Return value 


Tag_Name 
name of the tag 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


The value of the tag in the data type "signed char" 
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See also 
Tag statuses (Page 1598) 
GetTagSByteStateWait example (Page 1553) 
Functionality of the GetTag functions (Page 1409) 
GetTagSDWordStateWait 
Function 
Determines the value of a tag of data type "signed 32 bit". The value is read explicitly from the 
AS. The status of the tag is also returned. 
Syntax 
long GetTagSDWordStateWait(Tag Tag_Name, PDWORD Ip_dwstate); 
Parameters 


Return value 


Tag_Name 
name of the tag 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


Value of the tag in the data type "long" 


See also 
Tag statuses (Page 1598) 
GetTagSByteStateWait example (Page 1553) 
Functionality of the GetTag functions (Page 1409) 
GetTagSWordStateWait 
Function 
Determines the value of a tag of data type "signed 16 bit". The value is read explicitly from the 
AS. The status of the tag is also returned. 
WinCC: Scripting (VBS, ANSI-C, VBA) 
1420 System Manual, 02/2016, A5E37536061-AA 


ANSI-C for Creating Functions and Actions 
2.15 ANSI-C function descriptions 


Syntax 
short GetTagSWordStateWait(Tag Tag_Name, PDWORD Ip_dwstate); 


Parameters 


Tag_Name 
name of the tag 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


Return value 
Value of the tag in the data type "short" 


See also 
Functionality of the GetTag functions (Page 1409) 
Tag statuses (Page 1598) 
GetTagSByteStateWait example (Page 1553) 
GetTagWordStateWait 
Function 
Determines the value of a tag of data type "unsigned 16 bit". The value is read explicitly from 
the AS. The status of the tag is also returned. 
Syntax 
WORD GetTagWordStateWait(Tag Tag_Name, PDWORD Ip_dwstate); 
Parameters 


Tag_Name 
name of the tag 


lp_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 
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Return value 


See also 


GetTagBitState 


Function 


Syntax 


Parameters 


Return value 


See also 


GetTagByteState 


Function 


1422 


Value of the tag in the data type "WORD" 


Tag statuses (Page 1598) 
GetTagWordStateWait example (Page 1554) 
Functionality of the GetTag functions (Page 1409) 


Determines the value of a tag of data type "Binary tag". The status of the tag is also returned. 


BOOL GetTagBitState(Tag Tag_Name, PDWORD Ip_dwstate); 


Tag_Name 
name of the tag 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


Value of the tag in the data type "BOOL" 


Tag statuses (Page 1598) 
GetTagBitStateWait example (Page 1541) 
Functionality of the GetTag functions (Page 1409) 


Determines the value of a tag of data type "unsigned 8 bit". The status of the tag is also returned. 
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Syntax 


Parameters 


Return value 


2.15 ANSI-C function descriptions 


BYTE GetTagByteState(Tag Tag_Name, PDWORD Ip_dwstate); 


Tag_Name 
name of the tag 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


Value of the tag in the data type "BYTE" 


See also 
Tag statuses (Page 1598) 
GetTagWordStateWait example (Page 1554) 
Functionality of the GetTag functions (Page 1409) 
GetTagCharState 
Function 
Determines the value of a tag of data type "8-bit text tag" or "16-bit text tag". The status of the 
tag is also returned. 
Syntax 
char* GetTagCharState(Tag Tag_Name, PDWORD Ip_dwstate); 
Parameters 


Tag_Name 
name of the tag 


lp_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 
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Return value 


Pointer to the value of the tag in data type "char". 


The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 

pszValue = GetText (lpszPictureName, "Text1") ; 

if(pszValue != NULL) 


See also 
Tag statuses (Page 1598) 
Beispiel GetTagCharStateWait (Page 1544) 
Functionality of the GetTag functions (Page 1409) 
GetTagDoubleState 
Function 
Determines the value of a tag of data type "64-bit floating point value". The status of the tag 
is also returned. 
Syntax 
double GetTagDoubleState(Tag Tag_Name, PDWORD Ip_dwstate); 
Parameters 


Return value 
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Tag_Name 
name of the tag 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


Value of the tag in the data type "double" 
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See also 
Tag statuses (Page 1598) 
GetTagFloatStateWait example (Page 1546) 
Functionality of the GetTag functions (Page 1409) 
GetTagDWordState 
Function 
Determines the value of a tag of data type "unsigned 32 bit". The status of the tag is also 
returned. 
Syntax 
DWORD GetTagDWordState(Tag Tag_Name, PDWORD Ip_dwstate); 
Parameters 


Tag_Name 
name of the tag 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


Return value 
Value of the tag in the data type "DWORD" 


See also 
Tag statuses (Page 1598) 
GetTagWordStateWait example (Page 1554) 
Functionality of the GetTag functions (Page 1409) 
GetTagFloatState 
Function 


Determines the value of a tag of data type "32-bit floating point value". The status of the tag 
is also returned. 
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Syntax 
float GetTagFloatState(Tag Tag_Name, PDWORD Ip_dwstate); 


Parameters 


Tag_Name 
name of the tag 


lp_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


Return value 
Value of the tag in the data type "float" 


See also 
GetTagFloatStateWait example (Page 1546) 
Tag statuses (Page 1598) 
Functionality of the GetTag functions (Page 1409) 
GetTagRawState 
Function 
Determines the value of a tag of data type "Raw data type". The status of the tag is also 
returned. 
Syntax 
BOOL GetTagRawState(Tag Tag_Name, BYTE* pValue, DWORD size, PDWORD 
lp_dwstate); 
Parameters 
Tag_Name 


name of the tag 


pValue 
The pointer to a byte field which contains the value of the raw data tag 
size 


Size of the byte field in bytes 
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Return value 


2.15 ANSI-C function descriptions 


lp_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
Tag statuses (Page 1598) 
GetTagRawStateWait example (Page 1551) 
Functionality of the GetTag functions (Page 1409) 
GetTagSByteState 
Function 
Determines the value of a tag of data type "signed 8 bit". The status of the tag is also returned. 
Syntax 
signed char GetTagSByteState(Tag Tag_Name, PDWORD Ip_dwstate); 
Parameters 


Return value 


Tag_Name 
name of the tag 


lp_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


The value of the tag in the data type "signed char" 
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See also 
Tag statuses (Page 1598) 
GetTagSByteStateWait example (Page 1553) 
Functionality of the GetTag functions (Page 1409) 
GetTagSDWordState 
Function 
Determines the value of a tag of data type "signed 32 bit". The status of the tag is also returned. 
Syntax 
long GetTagSDWordState(Tag Tag_Name, PDWORD Ip_dwstate); 
Parameters 


Tag_Name 
name of the tag 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


Return value 
Value of the tag in the data type "long" 


See also 
Tag statuses (Page 1598) 
GetTagSByteStateWait example (Page 1553) 
Functionality of the GetTag functions (Page 1409) 
GetTagSWordState 
Function 
Determines the value of a tag of data type "signed 16 bit". The status of the tag is also returned. 
Syntax 


short GetTagSWordState(Tag Tag_Name, PDWORD Ip_dwstate); 
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Parameters 


Return value 


2.15 ANSI-C function descriptions 


Tag_Name 
name of the tag 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


Value of the tag in the data type "short" 


See also 
Tag statuses (Page 1598) 
GetTagSByteStateWait example (Page 1553) 
Functionality of the GetTag functions (Page 1409) 
GetTagWordState 
Function 
Determines the value of a tag of data type "unsigned 16 bit". The status of the tag is also 
returned. 
Syntax 
WORD GetTagWordState(Tag Tag_Name, PDWORD Ip_dwstate); 
Parameters 


Return value 


Tag_Name 
name of the tag 


lp_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


Value of the tag in the data type "WORD" 
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See also 
Tag statuses (Page 1598) 
GetTagWordStateWait example (Page 1554) 
Functionality of the GetTag functions (Page 1409) 
stateqc 
wait 
GetTagBitStateQCWait 
Function 
Determines the value of a tag of data type "Binary tag". The value is read explicitly from the 
AS. In addition, the status and the quality code of the tags are returned. 
Syntax 
BOOL GetTagBitStateQCWait(Tag Tag_Name, PDWORD Ip_dwstate, PD WORD 
pdwQualityCode); 
Parameters 


Return value 


See also 


1430 


Tag_Name 
Name of the tag. 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


pdwQualityCode 
Pointer to a DWORD in which the quality code of the tag is stored after the function is complete. 


Value of the tags in the data type "BOOL". 


Tag statuses (Page 1598) 
GetTagWordStateQCWait example (Page 1554) 
Functionality of the GetTag functions (Page 1409) 
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GetTagByteStateQCWait 


Function 


Syntax 


Parameters 


Return value 


Determines the value of a tag of data type "unsigned 8 bit". The value is read explicitly from 
the AS. In addition, the status and the quality code of the tags are returned. 


BYTE GetTagByteStateQCWait(Tag Tag_Name, PDWORD Ip_dwstate, PDWORD 
pdwQualityCode); 


Tag_Name 
Name of the tag. 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


pdwQualityCode 
Pointer toa DWORD in which the quality code of the tag is stored after the function is complete. 


Value of the tag in the data type "BYTE". 


See also 
Tag statuses (Page 1598) 
GetTagWordStateQCWait example (Page 1554) 
Functionality of the GetTag functions (Page 1409) 
GetTagCharStateQCWait 
Function 
Determines the value of a tag of data type "8-bit text tag" or "16-bit text tag". The value is read 
explicitly from the AS. In addition, the status and the quality code of the tags are returned. 
Syntax 


char* GetTagCharStateQCWait(Tag Tag_Name, PDWORD Ip_dwstate, PPWORD 
pdwQualityCode); 
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Parameters 


Return value 


See also 


Tag_Name 
Name of the tag. 


Ip_dwstate 

Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 

pdwQualityCode 

Pointer to a DWORD in which the quality code of the tag is stored after the function is complete. 


Pointer to the value of the tag in data type "char". 


The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 

pszValue = GetText (lpszPictureName, "Text1") ; 

if(pszValue != NULL) 


Tag statuses (Page 1598) 
GetTagCharStateQCWait example (Page 1543) 
Functionality of the GetTag functions (Page 1409) 


GetTagDoubleStateQCWait 


Function 


Syntax 


Parameters 


1432 


Determines the value of a tag of data type "64-bit floating point value". The value is read 
explicitly from the AS. In addition, the status and the quality code of the tags are returned. 


double GetTagDoubleStateQCWait(Tag Tag_Name, PDWORD Ip_dwstate, PDWORD 
pdwQualityCode); 


Tag_Name 
Name of the tag. 
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Return value 


See also 


2.15 ANSI-C function descriptions 


lp_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


pdwQualityCode 
Pointer toa DWORD in which the quality code of the tag is stored after the function is complete. 


Value of the tag in the data type "double". 


Tag statuses (Page 1598) 
GetTagFloatStateQCWait example (Page 1545) 
Functionality of the GetTag functions (Page 1409) 


GetTagDWordStateQCWait 


Function 


Syntax 


Parameters 


Return value 


Determines the value of a tag of data type "unsigned 32 bit". The value is read explicitly from 
the AS. In addition, the status and the quality code of the tags are returned. 


DWORD GetTagDWordStateQCWait(Tag Tag_Name, PDWORD Ip_dwstate, PDWORD 
pdwQualityCode); 


Tag_Name 
Name of the tag. 


lp_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


pdwQualityCode 
Pointer toa DWORD in which the quality code of the tag is stored after the function is complete. 


Value of the tag in the data type "DWORD". 
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See also 
Tag statuses (Page 1598) 
GetTagWordStateQCWait example (Page 1554) 
Functionality of the GetTag functions (Page 1409) 
GetTagFloatStateQCWait 
Function 
Determines the value of a tag of data type "32-bit floating point value". The value is read 
explicitly from the AS. In addition, the status and the quality code of the tags are returned. 
Syntax 
float GetTagFloatStateQCWait(Tag Tag_Name, PDWORD Ip_dwstate, PPDWORD 
pdwQualityCode); 
Parameters 


Return value 


See also 


1434 


Tag_Name 
Name of the tag. 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


pdwQualityCode 
Pointer to a DWORD in which the quality code of the tag is stored after the function is complete. 


Value of the tag in the data type "float". 


Tag statuses (Page 1598) 
GetTagFloatStateQCWait example (Page 1545) 
Functionality of the GetTag functions (Page 1409) 
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GetTagMultiStateQCWait 


Function 


Syntax 


Parameters 


Return value 


See also 


The values, states and quality codes are determined for several tags and are stored in the 
respective addresses in the specified format. The values are read explicitly from the AS. 


The function must be provided with two DWORD arrays, the member of which contains the 
states and quality codes of the individual tags after the function has been called. The size of 
the arrays must be selected so that sufficient memory space is available for these statuses. 


BOOL GetTagMultiStateQCWait(DWORD* pdwState, DWORD* pdwQualityCode, const char* 
pFormat) 


pdwState 
Field in which the status of the individual tags is stored after the function has been completed. 


pdwQualityCode 


Field in which the quality codes of the individual tags is stored after the function has been 
completed. 


pFormat 
Format description for all requested tags and for each tag name and address of the value. 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Format descriptors (Page 1593) 

Tag statuses (Page 1598) 
GetTagMultiStateQCWait example (Page 1547) 
Functionality of the GetTag functions (Page 1409) 
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GetTagRawStateQCWait 


Function 


Syntax 


Parameters 


Return value 


See also 


1436 


Determines the value of a tag of data type "Raw data type". The value is read explicitly from 
the AS. In addition, the status and the quality code of the tags are returned. 


BOOL GetTagRawStateQCWait(Tag Tag_Name, BYTE pValue, DWORD size, PPWORD 
lp_dwstate, PDWORD pdwdQualityCode); 


Tag_Name 
Name of the tag. 


pValue 
Pointer to a byte field containing the value of the raw data tag. 


size 
Size of the byte field in bytes. 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


pdwQualityCode 
Pointer to a DWORD in which the quality code of the tag is stored after the function is complete. 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Tag statuses (Page 1598) 
GetTagRawStateQCWait example (Page 1550) 
Functionality of the GetTag functions (Page 1409) 
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GetTagSByteStateQCWait 


Function 


Syntax 


Parameters 


Return value 


See also 


Determines the value of a tag of data type "signed 8 bit". The value is read explicitly from the 
AS. In addition, the status and the quality code of the tags are returned. 


signed char GetTagSByteStateQCWait(Tag Tag_Name, PDWORD Ip_dwstate, PDWORD 
pdwQualityCode); 


Tag_Name 
Name of the tag. 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


pdwQualityCode 
Pointer toa DWORD in which the quality code of the tag is stored after the function is complete. 


Value of the tag in the data type "signed char". 


Tag statuses (Page 1598) 
GetTagSByteStateQCWait example (Page 1552) 
Functionality of the GetTag functions (Page 1409) 


GetTagSDWordStateQCWait 


Function 


Determines the value of a tag of data type "signed 32 bit". The value is read explicitly from the 
AS. In addition, the status and the quality code of the tags are returned. 
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Syntax 


Parameters 


Return value 


See also 


long GetTagSDWordStateQCWait(Tag Tag_Name, PDWORD Ip_dwstate, PPDWORD 
pdwQualityCode); 


Tag_Name 
Name of the tag. 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


pdwQualityCode 
Pointer toa DWORD in which the quality code of the tag is stored after the function is complete. 


Value of the tags in the data type "long". 


Tag statuses (Page 1598) 
GetTagSByteStateQCWait example (Page 1552) 
Functionality of the GetTag functions (Page 1409) 


GetTagSWordStateQCWait 


Function 


Syntax 


Parameters 


1438 


Determines the value of a tag of data type "signed 16 bit". The value is read explicitly from the 
AS. In addition, the status and the quality code of the tags are returned. 


short GetTagSWordStateQCWait(Tag Tag_Name, PDWORD Ip_dwstate, PDWORD 
pdwQualityCode); 


Tag_Name 
Name of the tag. 
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Return value 
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lp_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


pdwQualityCode 
Pointer toa DWORD in which the quality code of the tag is stored after the function is complete. 


Value of the tag in the data type "short". 


See also 
Tag statuses (Page 1598) 
GetTagSByteStateQCWait example (Page 1552) 
Functionality of the GetTag functions (Page 1409) 
GetTagValueStateQCWait 
Function 
Enables the transfer of a value in the form of a variant. Establishes the pointer to the result 
structure containing the value. The value is read explicitly from the AS. In addition, the status 
and the quality code of the tags are returned. 
Syntax 
BOOL GetTagValueStateQCWait(_PDM_VARKEY IpdmVarKey, 
LPDM_VAR_UPDATE_STRUCTEX Ipdmresult, LPCMN_ERROR IpdmError); 
Parameters 


IpdmVarKey 
Pointer to a structure of the data type "DM_VARKEY" 


Ipdmresult 
Pointer to the value from data type "DM_VAR_UPDATE_STRUCTEX" 


IpdmError 
Pointer to the structure which contains the error description 
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Return value 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
Structure definition CMN_ERROR (Page 1601) 
Structure definition DM_VAR_UPDATE_STRUCTEX (Page 1604) 
Structure definition DM_VARKEY (Page 1605) 
Functionality of the GetTag functions (Page 1409) 
GetTagWordStateQCWait 
Function 
Determines the value of a tag of data type "unsigned 16 bit". The value is read explicitly from 
the AS. In addition, the status and the quality code of the tags are returned. 
Syntax 
WORD GetTagWordStateQCWait(Tag Tag_Name, PDWORD Ip_dwstate, PD WORD 
pdwQualityCode); 
Parameters 


Return value 
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Tag_Name 
Name of the tag. 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


pdwQualityCode 
Pointer to a DWORD in which the quality code of the tag is stored after the function is complete. 


Value of the tag in the data type "WORD". 
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See also 
Tag statuses (Page 1598) 
GetTagWordStateQCWait example (Page 1554) 
Functionality of the GetTag functions (Page 1409) 
GetTagBitStateQC 
Function 
Determines the value of a tag of data type "Binary tag". In addition, the status and the quality 
code of the tags are returned. 
Syntax 
BOOL GetTagBitStateQC(Tag Tag_Name, PDWORD Ip_dwstate, PDWORD 
pdwQualityCode); 
Parameters 


Return value 


See also 


Tag_Name 
Name of the tag. 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


pdwQualityCode 
Pointer toa DWORD in which the quality code of the tag is stored after the function is complete. 


Value of the tags in the data type "BOOL". 


Tag statuses (Page 1598) 
GetTagBitStateQC example (Page 1540) 
Functionality of the GetTag functions (Page 1409) 
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GetTagByteStateQC 


Function 


Syntax 


Parameters 


Return value 


Determines the value of a tag of data type "unsigned 8 bit". In addition, the status and the 
quality code of the tags are returned. 


BYTE GetTagByteStateQC(Tag Tag_Name, PDWORD Ip_dwstate, PDWORD 
pdwQualityCode); 


Tag_Name 
Name of the tag. 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


pdwQualityCode 
Pointer toa DWORD in which the quality code of the tag is stored after the function is complete. 


Value of the tag in the data type "BYTE". 


See also 
Tag statuses (Page 1598) 
GetTagWordStateQCWait example (Page 1554) 
Functionality of the GetTag functions (Page 1409) 
GetTagCharStateQC 
Function 
Determines the value of a tag of data type "8-bit text tag" or "16-bit text tag". In addition, the 
status and the quality code of the tags are returned. 
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Syntax 


Parameters 


Return value 
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char* GetTagCharStateQC(Tag Tag_Name, PDWORD Ip_dwstate, PDWORD 
pdwQualityCode); 


Tag_Name 
Name of the tag. 


Ip_dwstate 

Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 

pdwQualityCode 

Pointer toa DWORD in which the quality code of the tag is stored after the function is complete. 


Pointer to the value of the tag in data type "char". 


The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 

pszValue = GetText (lpszPictureName, "Text1") ; 

if(pszValue != NULL) 


See also 
Tag statuses (Page 1598) 
GetTagCharStateQCWait example (Page 1543) 
Functionality of the GetTag functions (Page 1409) 
GetTagDoubleStateQC 
Function 
Determines the value of a tag of data type "64-bit floating point value". In addition, the status 
and the quality code of the tags are returned. 
Syntax 


double GetTagDoubleStateQC(Tag Tag_Name, PDWORD Ip_dwstate, PDWORD 
pdwQualityCode); 
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Parameters 


Return value 


Tag_Name 
Name of the tag. 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


pdwQualityCode 
Pointer toa DWORD in which the quality code of the tag is stored after the function is complete. 


Value of the tag in the data type "double". 


See also 
GetTagFloatStateQCWait example (Page 1545) 
Tag statuses (Page 1598) 
Functionality of the GetTag functions (Page 1409) 
GetTagDWordStateQC 
Function 
Determines the value of a tag of data type "unsigned 32 bit". In addition, the status and the 
quality code of the tags are returned. 
Syntax 
DWORD GetTagDWordStateQC(Tag Tag_Name, PDWORD Ip_dwstate, PPWORD 
pdwQualityCode); 
Parameters 
Tag_Name 
Name of the tag. 
Ip_dwstate 
Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 
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pdwQualityCode 
Pointer toa DWORD in which the quality code of the tag is stored after the function is complete. 


Value of the tag in the data type "DWORD". 


See also 
Tag statuses (Page 1598) 
GetTagWordStateQCWait example (Page 1554) 
Functionality of the GetTag functions (Page 1409) 
GetTagFloatStateQC 
Function 
Determines the value of a tag of data type "32-bit floating point value". In addition, the status 
and the quality code of the tags are returned. 
Syntax 
float GetTagFloatStateQC(Tag Tag_Name, PDWORD Ip_dwstate, PPWORD 
pdwQualityCode); 
Parameters 


Return value 


Tag_Name 
Name of the tag. 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


pdwQualityCode 
Pointer toa DWORD in which the quality code of the tag is stored after the function is complete. 


Value of the tag in the data type "float". 
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See also 
GetTagFloatStateQCWait example (Page 1545) 
Tag statuses (Page 1598) 
Functionality of the GetTag functions (Page 1409) 
GetTagRawStateQC 
Function 
Determines the value of a tag of data type "Raw data type". In addition, the status and the 
quality code of the tags are returned. 
Syntax 
BOOL GetTagRawStateQC(Tag Tag_Name, BYTE* pValue, DWORD size, PPWORD 
lp_dwstate, PDWORD pdwdQualityCode); 
Parameters 


Return value 


1446 


Tag_Name 
Name of the tag. 


pValue 
Pointer to a byte field containing the value of the raw data tag. 


size 
Size of the byte field in bytes. 


lp_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


pdwQualityCode 
Pointer to a DWORD in which the quality code of the tag is stored after the function is complete. 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 
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See also 
Tag statuses (Page 1598) 
GetTagRawStateQCWait example (Page 1550) 
Functionality of the GetTag functions (Page 1409) 
GetTagSByteStateQC 
Function 
Determines the value of a tag of data type "signed 8 bit". In addition, the status and the quality 
code of the tags are returned. 
Syntax 
signed char GetTagSByteStateQC(Tag Tag_Name, PDWORD Ip_dwstate, PDWORD 
pdwQualityCode); 
Parameters 


Return value 


See also 


Tag_Name 
Name of the tag. 


lp_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


pdwQualityCode 
Pointer toa DWORD in which the quality code of the tag is stored after the function is complete. 


Value of the tag in the data type "signed char". 


Tag statuses (Page 1598) 
GetTagSByteStateQCWait example (Page 1552) 
Functionality of the GetTag functions (Page 1409) 
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GetTagSDWordStateQC 


Function 


Syntax 


Parameters 


Return value 


Determines the value of a tag of data type "signed 32 bit". In addition, the status and the quality 
code of the tags are returned. 


long GetTagSDWordStateQC(Tag Tag_Name, PDWORD Ip_dwstate, PDWORD 
pdwQualityCode); 


Tag_Name 
Name of the tag. 


lp_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


pdwQualityCode 
Pointer toa DWORD in which the quality code of the tag is stored after the function is complete. 


Value of the tags in the data type "long". 


See also 
Tag statuses (Page 1598) 
GetTagSByteStateQCWait example (Page 1552) 
Functionality of the GetTag functions (Page 1409) 
GetTagSWordStateQC 
Function 
Determines the value of a tag of data type "signed 16 bit". In addition, the status and the quality 
code of the tags are returned. 
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Syntax 


Parameters 


Return value 
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short GetTagSWordStateQC(Tag Tag_Name, PDWORD Ip_dwstate, PDWORD 
pdwQualityCode); 


Tag_Name 
Name of the tag. 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


pdwQualityCode 
Pointer toa DWORD in which the quality code of the tag is stored after the function is complete. 


Value of the tag in the data type "short". 


See also 
Tag statuses (Page 1598) 
GetTagSByteStateQCWait example (Page 1552) 
Functionality of the GetTag functions (Page 1409) 
GetTagValueStateQC 
Function 
Enables the transfer of a value in the form of a variant. Establishes the pointer to the result 
structure containing the value. In addition, the status and the quality code of the tags are 
returned. 
Syntax 
BOOL GetTagValueStateQC(LPDM_VARKEY IpdmVarkey, 
LPDM_VAR_UPDATE_STRUCTEX Ipdmresult, LPCMN_ERROR IpdmError); 
Parameters 


IpdmVarKey 
Pointer to a structure of the data type "DM_VARKEY" 
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Return value 


Ipdmresult 
Pointer to the value from data type "DM_VAR_UPDATE_STRUCTEX" 


IpdmError 
Pointer to the structure which contains the error description 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


See also 
Structure definition CMN_ERROR (Page 1601) 
Structure definition DM_VAR_UPDATE_STRUCTEX (Page 1604) 
Structure definition DM_VARKEY (Page 1605) 
Functionality of the GetTag functions (Page 1409) 
GetTagWordStateQC 
Function 
Determines the value of a tag of data type "unsigned 16 bit". In addition, the status and the 
quality code of the tags are returned. 
Syntax 
WORD GetTagWordStateQC(Tag Tag_Name, PDWORD Ip_dwstate, PPWORD 
pdwQualityCode); 
Parameters 
Tag_Name 
Name of the tag. 
Ip_dwstate 
Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 
pdwQualityCode 
Pointer to a DWORD in which the quality code of the tag is stored after the function is complete. 
WinCC: Scripting (VBS, ANSI-C, VBA) 
1450 System Manual, 02/2016, A5E37536061-AA 


ANSI-C for Creating Functions and Actions 
2.15 ANSI-C function descriptions 


Return value 
Value of the tag in the data type "WORD". 


See also 
Tag statuses (Page 1598) 
GetTagWordStateQCWait example (Page 1554) 
Functionality of the GetTag functions (Page 1409) 
wait 
GetTagBitWait 
Function 
Determines the value of a tag of data type "Binary tag". The value is read explicitly from the 
AS. 
Syntax 
BOOL GetTagBitWait(Tag Tag_Name); 
Parameters 


Tag_Name 
name of the tag 


Return value 
Value of the tag in the data type "BOOL" 


See also 
GetTagBit example (Page 1539) 
Functionality of the GetTag functions (Page 1409) 
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GetTagByteWait 

Function 
Determines the value of a tag of data type "unsigned 8 bit". The value is read explicitly from 
the AS. 

Syntax 
BYTE GetTagByteWait(Tag Tag_Name); 

Parameters 


Tag_Name 
name of the tag 


Return value 
Value of the tag in the data type "BYTE" 


See also 
GetTagWord example (Page 1553) 
Functionality of the GetTag functions (Page 1409) 
GetTagCharWait 
Function 
Determines the value of a tag of data type "8-bit text tag" or "16-bit text tag". The value is read 
explicitly from the AS. 
Syntax 
char* GetTagCharWait(Tag Tag_Name); 
Parameters 


Tag_Name 


name of the tag 


Return value 


Pointer to a character string containing the value of the tag. 
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The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 

pszValue = GetText (lpszPictureName, "Text1") ; 

if(pszValue != NULL) 


See also 
GetTagChar example (Page 1542) 
Functionality of the GetTag functions (Page 1409) 
GetTagDoubleWait 
Function 
Determines the value of a tag of data type "64-bit floating point value". The value is read 
explicitly from the AS. 
Syntax 
double GetTagDoubleWait(Tag Tag_Name); 
Parameters 


Return value 


Tag_Name 
name of the tag 


Value of the tag in the data type "double" 


See also 

GetTagFloat example (Page 1544) 

Functionality of the GetTag functions (Page 1409) 
GetTagDWordWait 
Function 


Determines the value of a tag of data type "unsigned 32 bit". The value is read explicitly from 
the AS. 
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Syntax 
DWORD GetTagDWordWait(Tag Tag_Name); 


Parameters 


Tag_Name 
name of the tag 


Return value 
Value of the tag in the data type "DWORD" 


See also 
Functionality of the GetTag functions (Page 1409) 
GetTagWord example (Page 1553) 
GetTagFloatWait 
Function 
Determines the value of a tag of data type "32-bit floating point value". The value is read 
explicitly from the AS. 
Syntax 
float GetTagFloatWait(Tag Tag_Name); 
Parameters 


Tag_Name 
name of the tag 


Return value 
Value of the tag in the data type "float" 


See also 
GetTagFloat example (Page 1544) 
Functionality of the GetTag functions (Page 1409) 
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GetTagMultiWait 


Function 


Syntax 


Parameters 


Return value 


See also 


GetTagRawWait 


Function 


Syntax 


2.15 ANSI-C function descriptions 


The values of several tags are established and stored in the corresponding addresses in the 
specified format. The value is read explicitly from the AS. The memory for the tag value is 
created by the function with SysMalloc. 


BOOL GetTagMultiWait(const char* pFormat....) 


pFormat 
Format description for all requested tags and for each tag name and address of the value 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


Format descriptors (Page 1593) 
GetTagMultiWait example (Page 1549) 
Functionality of the GetTag functions (Page 1409) 


Determines the value of a tag of data type "Raw data type". The value is read explicitly from 
the AS. 


BOOL GetTagRawWait(Tag Tag_Name , BYTE pValue, DWORD size); 
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Parameters 


Return value 


Tag_Name 
name of the tag 


pValue 

The pointer to a byte field which contains the value of the raw data tag 
size 

Size of the byte field in bytes 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


See also 
Functionality of the GetTag functions (Page 1409) 
GetTagRaw example (Page 1550) 
GetTagSByteWait 
Function 
Determines the value of a tag of data type "signed 8 bit". The value is read explicitly from the 
AS. 
Syntax 
signed char GetTagSByteWait(Tag Tag_Name); 
Parameters 


Return value 
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Tag_Name 
name of the tag 


The value of the tag in the data type "signed char" 
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See also 
GetTagSByte example (Page 1552) 
Functionality of the GetTag functions (Page 1409) 
GetTagSDWordWait 
Function 
Determines the value of a tag of data type "signed 32 bit". The value is read explicitly from the 
AS. 
Syntax 
long GetTagSDWordWait(Tag Tag_Name); 
Parameters 


Tag_Name 
name of the tag 


Return value 
Value of the tag in the data type "long" 


See also 
GetTagSByte example (Page 1552) 
Functionality of the GetTag functions (Page 1409) 
GetTagSWordWait 
Function 
Determines the value of a tag of data type "signed 16 bit". The value is read explicitly from the 
AS. 
Syntax 


short GetTagSWordWait(Tag Tag_Name); 
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Parameters 


Return value 


Tag_Name 
name of the tag 


Value of the tag in the data type "short" 


See also 
GetTagSByte example (Page 1552) 
Functionality of the GetTag functions (Page 1409) 

GetTagValueWait 

Function 
Enables the transfer of a value in the form of a variant. Establishes the pointer to the result 
structure containing the value. The value is read explicitly from the AS. 

Syntax 
BOOL GetTagValueWait(_PDM_VARKEY IpdmVarkKey, LPDM_VAR_UPDATE_STRUCT 
lpdmresult, LPCMN_ERROR IpdmError); 

Parameters 


Return value 


1458 


IpdmVarKey 
Pointer to a structure of the data type "DM_VARKEY" 


Ipdmresult 
Pointer to the value from data type "DM_VAR_UPDATE_STRUCT" 


IpdmError 
Pointer to the structure which contains the error description 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 
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See also 
Structure definition CMN_ERROR (Page 1601) 
Structure definition DM_VAR_UPDATE_STRUCT (Page 1603) 
Structure definition DM_VARKEY (Page 1605) 
Functionality of the GetTag functions (Page 1409) 
GetTagWordWait 
Function 
Determines the value of a tag of data type "unsigned 16 bit". The value is read explicitly from 
the AS. 
Syntax 
WORD GetTagWordWait(Tag Tag_Name); 
Parameters 


Return value 


See also 


GetTagBit 


Function 


Syntax 


Tag_Name 
name of the tag 


Value of the tag in the data type "WORD" 


GetTagWord example (Page 1553) 


Functionality of the GetTag functions (Page 1409) 


Determines the value of a tag of data type "Binary tag". 


BOOL GetTagBit(Tag Tag_Name); 
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Parameters 


Tag_Name 
name of the tag 


Return value 
Value of the tag in the data type "BOOL" 


See also 

GetTagBit example (Page 1539) 

Functionality of the GetTag functions (Page 1409) 
GetTagByte 
Function 

Determines the value of a tag of data type "unsigned 8 bit". 
Syntax 

BYTE GetTagByte(Tag Tag_Name); 
Parameters 


Tag_Name 
name of the tag 


Return value 
Value of the tag in the data type "BYTE" 


See also 

GetTagWord example (Page 1553) 

Functionality of the GetTag functions (Page 1409) 
GetTagChar 
Function 


Determines the value of a tag of data type "8-bit text tag" or "16-bit text tag”. 
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Syntax 
char* GetTagChar(Tag Tag_Name); 


Parameters 


Tag_Name 
name of the tag 


Return value 
Pointer to a character string containing the value of the tag. 


The return value must be checked for validity to prevent a null pointer exception, e.g. with the 
function "GetText()": 

pszValue = GetText (lpszPictureName, "Text1") ; 

if(pszValue != NULL) 


See also 

GetTagChar example (Page 1542) 

Functionality of the GetTag functions (Page 1409) 
GetTagDateTime 
Function 

Determines the value of a tag of data type "Date/Time". 
Syntax 

SYSTEMTIME GetTagDateTime(Tag Tag_Name); 
Parameter 


Tag_Name 
Name of the tag 


Return value 
Value of the tag in the data type "Date/Time". 
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GetTagDouble 
Function 
Determines the value of a tag of data type "64-bit floating point value". 
Syntax 
double GetTagDouble(Tag Tag_Name); 
Parameters 


Tag_Name 
name of the tag 


Return value 
Value of the tag in the data type "double" 


See also 

GetTagFloat example (Page 1544) 

Functionality of the GetTag functions (Page 1409) 
GetTagDWord 
Function 

Determines the value of a tag of data type "unsigned 32 bit". 
Syntax 

DWORD GetTagDWord(Tag Tag_Name); 
Parameters 


Tag_Name 
name of the tag 


Return value 
Value of the tag in the data type "DWORD" 
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See also 
GetTagWord example (Page 1553) 
Functionality of the GetTag functions (Page 1409) 
GetTagFloat 
Function 
Determines the value of a tag of data type "32-bit floating point value". 
Syntax 
float GetTagFloat(Tag Tag_Name); 
Parameters 


Tag_Name 
name of the tag 


Return value 
Value of the tag in the data type "float". 


See also 

GetTagFloat example (Page 1544) 

Functionality of the GetTag functions (Page 1409) 
GetTagRaw 
Function 

Determines the value of a tag of data type "Raw data type". 
Syntax 

BOOL GetTagRaw(Tag Tag_Name, BYTE* pValue, DWORD size); 
Parameters 


Tag_Name 
name of the tag 
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Return value 


See also 


GetTagSByte 


Function 


Syntax 


Parameters 


Return value 


See also 


1464 


pValue 
The pointer to a byte field which contains the value of the raw data tag 


size 
Size of the byte field in bytes 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


GetTagRaw example (Page 1550) 


Functionality of the GetTag functions (Page 1409) 


Determines the value of a tag of data type "signed 8 bit". 


signed char GetTagSByte(Tag Tag_Name); 


Tag_Name 
name of the tag 


The value of the tag in the data type "signed char" 


GetTagSByte example (Page 1552) 
Functionality of the GetTag functions (Page 1409) 
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GetTagSDWord 


Function 


Determines the value of a tag of data type "signed 32 bit". 


Syntax 
long GetTagSDWord(Tag Tag_Name); 


Parameters 


Tag_Name 
name of the tag 


Return value 
Value of the tag in the data type "long" 


See also 

GetTagSByte example (Page 1552) 

Functionality of the GetTag functions (Page 1409) 
GetTagSWord 
Function 

Determines the value of a tag of data type "signed 16 bit". 
Syntax 

short GetTagSWord(Tag Tag_Name); 
Parameters 


Tag_Name 
name of the tag 


Return value 
Value of the tag in the data type "short" 
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See also 


GetTagValue 


Function 


Syntax 


Parameters 


Return value 


See also 


1466 


GetTagSByte example (Page 1552) 
Functionality of the GetTag functions (Page 1409) 


Enables the transfer of a value in the form of a variant. Establishes the pointer to the result 
structure containing the value. 


BOOL GetTagValue(LPDM_VARKEY IpdmVarKey, LPDM_VAR_UPDATE_STRUCT 
Ipdmresult, LPCMN_ERROR IpdmError); 


IpdmVarKey 
Pointer to a structure of the data type "DM_VARKEY" 


Ipdmresult 
Pointer to the value from data type "DM_VAR_UPDATE_STRUCT" 


IpdmError 
Pointer to the structure which contains the error description 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Structure definition CMN_ERROR (Page 1601) 

Structure definition DM_VAR_UPDATE_STRUCT (Page 1603) 
Structure definition DM_VARKEY (Page 1605) 

Functionality of the GetTag functions (Page 1409) 
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GetTagWord 
Function 
Determines the value of a tag of data type "unsigned 16 bit". 
Syntax 
WORD GetTagWord(Tag Tag_Name); 
Parameters 


Tag_Name 
name of the tag 


Return value 
Value of the tag in the data type "WORD" 


See also 
GetTagWord example (Page 1553) 
Functionality of the GetTag functions (Page 1409) 


set 


Principle of the SetTag functions 


SetTagXXX 


The SetTagXXxX function assigns the job a value to write and returns immediately to the caller. 
In this case, the system does not wait until value is actually written. 


The call is marked by the following: 
e@ The call is fast. 
e@ The caller does not know when the value is actually written. 


e@ The function provides no information on the state of the write job. 


SetTagXXXWait 


The function SetTagXXXWait assigns the job of writing a value and will first return to the caller 
when the value has actually been written. 
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The call is marked by the following: 


e The call takes longer in comparison to SetTagXXxX. The duration is also dependent on the 
channel and AS, amongst other things. 


e The value is written after the call. 


e@ The function provides no information on the state of the write job. 


SetTagXxxState 


The function SetTagXXXState has the same features as SetTagXXX; plus the function returns 
information regarding the status of the write request. 


Since the status is always provided internally, there is no performance difference compared 
to SetTagxxx. 


SetTagXxXXxStateWait 


SetTagMultiWait 


The function SetTagXXXStateWait has the same features as SetTagXxXXWait; plus the 
function returns information regarding the status of the write request. 


Since the status is always provided internally, there is no performance difference compared 
to SetTagxXxxXWait. 


The difference between the functions SetTagXxXXStateWait and SetTagXXXState 
corresponds to the difference between SetTagXxXXWait and SetTagxXX. 


Note, that certain statuses can only be generated when the write process has been completed. 


The SetTagMultiWait function has the same features as SetTagXXXWait. It also offers the 
option of granting several write jobs in a single job. 


state 
wait 
SetTagBitStateWait 
Function 
Sets the value of a tag of data type "Binary tag". The function is ended after the AS has 
acknowledged acceptance of the value. The status of the tag is also returned. 
Principle of the SetTag 
functionsEXAMPLE_INTERNAL_FUNCTIONS_TAG_STATEWAIT_23_130 
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Syntax 


Parameters 


Return value 
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BOOL SetTagBitStateWait(Tag Tag_Name, short value, PPWORD Ip_dwstate); 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "short" 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. To do this, the 
tag status must be evaluated. 


FALSE 
An error has occurred. 


See also 
Tag statuses (Page 1598) 
Beispiel SetTagBitStateWait (Page 1570) 

SetTagByteStateWait 

Function 
Sets the value of a tag of the data type "unsigned 8 Bit". The function is ended after the AS 
has acknowledged acceptance of the value. The status of the tag is also returned. 
Principle of the SetTag 
functionsEXAMPLE_INTERNAL_FUNCTIONS_TAG_STATEWAIT_23_130 

Syntax 


BOOL SetTagByteStateWait(Tag Tag_Name, BYTE value, PDWORD Ip_dwstate); 
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Parameters 


Return value 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "BYTE" 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. To do this, the 
tag status must be evaluated. 


FALSE 


An error has occurred. 


See also 
Tag statuses (Page 1598) 
Beispiel SetTagWordStateWait (Page 1577) 
SetTagCharStateWait 
Function 
Sets the value of a tag of the data type " 8-bit text tag" or "16-bit text tag". The function is ended 
after the AS has acknowledged acceptance of the value. The status of the tag is also returned. 
Principle of the SetTag 
functionsEXAMPLE_INTERNAL_FUNCTIONS_TAG_STATEWAIT_23_130 
Syntax 
BOOL SetTagCharStateWait(Tag Tag_Name, LPSTR value, PDPWORD Ip_dwstate); 
Parameters 
Tag_Name 
name of the tag 
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value 
Value of the tag in the data type "LPSTR" 


lp_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


Return value 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. To do this, the 
tag status must be evaluated. 


FALSE 


An error has occurred. 


See also 
Tag statuses (Page 1598) 
SetTagCharStateWait example (Page 1571) 
SetTagDoubleStateWait 
Function 
Defines the value of a tag of the data type "64-bit floating point value". The function is ended 
after the AS has acknowledged acceptance of the value. The status of the tag is also returned. 
Principle of the SetTag 
functionsEXAMPLE_INTERNAL_FUNCTIONS_TAG_STATEWAIT_23_130 
Syntax 
BOOL SetTagDoubleStateWait(Tag Tag_Name, double value, PDWORD Ip_dwstate); 
Parameters 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "double" 
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Return value 


lp_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. To do this, the 
tag status must be evaluated. 


FALSE 
An error has occurred. 


See also 
Tag statuses (Page 1598) 
SetTagFloatStateWait example (Page 1572) 
SetTagDWordStateWait 
Function 
Sets the value of a tag of the data type "unsigned 32 Bit". The function is ended after the AS 
has acknowledged acceptance of the value. The status of the tag is also returned. 
Principle of the SetTag 
functionsEXAMPLE_INTERNAL_FUNCTIONS_TAG_STATEWAIT_23_130 
Syntax 
BOOL SetTagDWordStateWait(Tag Tag_Name, DWORD value, PDWORD Ip_dwstate); 
Parameters 
Tag_Name 
name of the tag 
value 
Value of the tag in the data type "DWORD" 
Ip_dwstate 
Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 
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Return value 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. To do this, the 
tag status must be evaluated. 


FALSE 
An error has occurred. 


See also 
Tag statuses (Page 1598) 
Beispiel SetTagWordStateWait (Page 1577) 
SetTagFloatStateWait 
Function 
Defines the value of a tag of the data type "32-bit floating point value". The function is ended 
after the AS has acknowledged acceptance of the value. The status of the tag is also returned. 
Principle of the SetTag 
functionsEXAMPLE_INTERNAL_FUNCTIONS_TAG_STATEWAIT_23_130 
Syntax 
BOOL SetTagFloatStateWait(Tag Tag_Name, float value, PDWORD Ip_dwstate); 
Parameters 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "float" 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


Return value 


TRUE 
The function itself has been completed without any errors. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 1473 


ANSI-C for Creating Functions and Actions 


2.15 ANSI-C function descriptions 


However, no test is made as to whether the tag could be written without errors. To do this, the 
tag status must be evaluated. 


FALSE 
An error has occurred. 


See also 
Tag statuses (Page 1598) 
SetTagFloatStateWait example (Page 1572) 

SetTagMultiStateWait 

Function 
Sets the values of several tags. The function is ended after the AS has acknowledged 
acceptance of the value. 
The function must transfer a DWORD array whose members contain the individual tag states 
after the function is invoked. The size of the array must be selected so that sufficient memory 
space is available for these statuses. 
Principle of the SetTag 
functionsEXAMPLE_INTERNAL_FUNCTIONS_TAG_STATEWAIT_23_130 

Syntax 
BOOL SetTagMultiStateWait(DWORD* pdwState, const char* pFormat....) 

Parameters 


Return value 


1474 


pdwState 
Field in which the tag statuses are stored. 


pFormat 
Format description for all requested tags and for each tag name and value. 
FormatdescriberEXAMPLES_INTERNAL_FUNCTIONS_TAG_STATEWAIT_23_130 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 


An error has occurred. 
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See also 
Tag statuses (Page 1598) 
SetTagMultiStateWait example (Page 1573) 

SetTagRawStateWait 

Function 
Sets the value of a tag of the data type "Raw data type". The function is ended after the AS 
has acknowledged acceptance of the value. The status of the tag is also returned. 
Principle of the SetTag 
functionsEXAMPLE_INTERNAL_FUNCTIONS_TAG_STATEWAIT_23_130 

Syntax 
BOOL SetTagRawStateWait(Tag Tag_Name, BYTE pValue, DWORD size, PPWORD 
lp_dwstate); 

Parameters 


Return value 


Tag_Name 
name of the tag 


pValue 

The pointer to a byte field which contains the value of the raw data tag 
size 

Size of the byte field in bytes 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. To do this, the 


tag status must be evaluated. 


FALSE 
An error has occurred. 
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See also 
Tag statuses (Page 1598) 
SetTagRawStateWait example (Page 1575) 
SetTagSByteStateWait 
Function 
Sets the value of a tag of the data type "signed 8 bit". The function is ended after the AS has 
acknowledged acceptance of the value. The status of the tag is also returned. 
Principle of the SetTag 
functionsEXAMPLE_INTERNAL_FUNCTIONS_TAG_STATEWAIT_23_130 
Syntax 
BOOL SetTagSByteStateWait(Tag Tag_Name, signed char value, PDWORD Ip_dwstate); 
Parameters 


Return value 


See also 


1476 


Tag_Name 
name of the tag 


value 
The value of the tag in the data type "signed char" 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. To do this, the 
tag status must be evaluated. 


FALSE 
An error has occurred. 


Tag statuses (Page 1598) 
Beispiel SetTagSByteStateWait (Page 1576) 
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SetTagSDWordStateWait 


Function 


Syntax 


Parameters 


Return value 


See also 


Sets the value of a tag of the data type "signed 32 bit". The function is ended after the AS has 
acknowledged acceptance of the value. The status of the tag is also returned. 


Principle of the SetTag 
functionsEXAMPLE_INTERNAL_FUNCTIONS_TAG_STATEWAIT_23_130 


BOOL SetTagSDWordStateWait(Tag Tag_Name, long value, PDWORD Ip_dwstate); 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "long" 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. To do this, the 
tag status must be evaluated. 


FALSE 
An error has occurred. 


Tag statuses (Page 1598) 
Beispiel SetTagSByteStateWait (Page 1576) 
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SetTagSWordStateWait 


Function 


Syntax 


Parameters 


Return value 


See also 


1478 


Sets the value of a tag of the data type "signed 16 bit". The function is ended after the AS has 
acknowledged acceptance of the value. The status of the tag is also returned. 


Principle of the SetTag 


functionsEXAMPLE_INTERNAL_FUNCTIONS_TAG_STATEWAIT_23_130 


BOOL SetTagSWordStateWait(Tag Tag_Name, short value, PDPWORD Ip_dwstate); 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "short" 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 


completed. 


TRUE 


The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. To do this, the 


tag status must be evaluated. 


FALSE 


An error has occurred. 


Tag statuses (Page 1598) 
Beispiel SetTagSByteStateWait (Page 1576) 
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SetTagWordStateWait 


Function 


Syntax 


Parameters 


Return value 


See also 


Sets the value of a tag of the data type "unsigned 16 Bit". The function is ended after the AS 
has acknowledged acceptance of the value. The status of the tag is also returned. 


Principle of the SetTag 
functionsEXAMPLE_INTERNAL_FUNCTIONS_TAG_STATEWAIT_23_130 


BOOL SetTagWordStateWait(Tag Tag_Name, WORD value, PDWORD Ip_dwstate); 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "WORD" 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. To do this, the 
tag status must be evaluated. 


FALSE 
An error has occurred. 


Tag statuses (Page 1598) 
Beispiel SetTagWordStateWait (Page 1577) 
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SetTagBitState 


Function 


Syntax 


Parameters 


Return value 


See also 


SetTagByteState 


Function 


1480 


Sets the value of a tag of data type "Binary tag". The status of the tag is also returned. 


BOOL SetTagBitState(Tag Tag_Name, short int value, PPWORD Ip_dwstate); 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "short int" 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. For this purpose, 
the tag status must be evaluated. 


FALSE 
An error has occurred. 


Tag statuses (Page 1598) 
Beispiel SetTagBitStateWait (Page 1570) 
Principle of the SetTag functions (Page 1467) 


Sets the value of a tag of the data type "unsigned 8 Bit". The status of the tag is also returned. 
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Syntax 


Parameters 


Return value 


See also 


2.15 ANSI-C function descriptions 


BOOL SetTagByteState(Tag Tag_Name, BYTE value, PDWORD Ip_dwstate); 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "BYTE" 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. For this purpose, 
the tag status must be evaluated. 


FALSE 
An error has occurred. 


Tag statuses (Page 1598) 
Beispiel SetTagWordStateWait (Page 1577) 
Principle of the SetTag functions (Page 1467) 


SetTagCharState 


Function 


Syntax 


Sets the value of a tag of the data type " 8-bit text tag" or "16-bit text tag". The status of the 
tag is also returned. 


BOOL SetTagCharState(Tag Tag_Name, LPSTR value, PDPWORD Ip_dwstate); 
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Parameters 


Return value 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "LPSTR" 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. For this purpose, 
the tag status must be evaluated. 


FALSE 
An error has occurred. 


See also 

Tag statuses (Page 1598) 

SetTagCharStateWait example (Page 1571) 

Principle of the SetTag functions (Page 1467) 
SetTagDoubleState 
Function 

Defines the value of a tag of the data type "64-bit floating point value". The status of the tag is 

also returned. 
Syntax 

BOOL SetTagDoubleState(Tag Tag_Name, double value, PDWORD Ip_dwstate); 
Parameters 

Tag_Name 

name of the tag 
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value 
Value of the tag in the data type "double" 


lp_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


Return value 
TRUE 


The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. For this purpose, 
the tag status must be evaluated. 


FALSE 


An error has occurred. 


See also 

Tag statuses (Page 1598) 

SetTagFloatStateWait example (Page 1572) 

Principle of the SetTag functions (Page 1467) 
SetTagDWordState 
Function 

Sets the value of a tag of the data type "unsigned 32 Bit". The status of the tag is also returned. 
Syntax 

BOOL SetTagDWordState(Tag Tag_Name, DWORD value, PDWORD Ip_dwstate); 
Parameters 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "DWORD" 


lp_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 
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Return value 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. For this purpose, 
the tag status must be evaluated. 


FALSE 
An error has occurred. 


See also 
Tag statuses (Page 1598) 
Beispiel SetTagWordStateWait (Page 1577) 
Principle of the SetTag functions (Page 1467) 
SetTagFloatState 
Function 
Defines the value of a tag of the data type "32-bit floating point value". The status of the tag is 
also returned. 
Syntax 
BOOL SetTagFloatState(Tag Tag_Name, float value, PDWORD Ip_dwstate); 
Parameters 


Return value 


1484 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "float" 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


TRUE 
The function itself has been completed without any errors. 
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However, no test is made as to whether the tag could be written without errors. For this purpose, 
the tag status must be evaluated. 


FALSE 
An error has occurred. 


See also 
Tag statuses (Page 1598) 
SetTagFloatStateWait example (Page 1572) 
Principle of the SetTag functions (Page 1467) 
SetTagRawState 
Function 
Sets the value of a tag of the data type "Raw data type". The status of the tag is also returned. 
Syntax 
BOOL SetTagRawState(Tag Tag_Name, BYTE* pValue, DWORD size, PDWORD 
lp_dwstate); 
Parameters 
Tag_Name 


name of the tag 


pValue 

The pointer to a byte field which contains the value of the raw data tag 
size 

Size of the byte field in bytes 


lp_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


Return value 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 
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FALSE 
An error has occurred. 


See also 

Tag statuses (Page 1598) 

GetTagRaw example (Page 1550) 

Principle of the SetTag functions (Page 1467) 
SetTagSByteState 
Function 

Sets the value of a tag of the data type "signed 8 bit". The status of the tag is also returned. 
Syntax 

BOOL SetTagSByteState(Tag Tag_Name, signed char value, PDWORD Ip_dwstate); 
Parameters 


Return value 


1486 


Tag_Name 
name of the tag 


value 
The value of the tag in the data type "signed char" 


lp_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. For this purpose, 
the tag status must be evaluated. 


FALSE 
An error has occurred. 
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See also 

Tag statuses (Page 1598) 

Beispiel SetTagSByteStateWait (Page 1576) 

Principle of the SetTag functions (Page 1467) 
SetTagSDWordState 
Function 

Sets the value of a tag of the data type "signed 32 bit". The status of the tag is also returned. 
Syntax 

BOOL SetTagSDWordState(Tag Tag_Name, long value, PDWORD Ip_dwstate); 
Parameters 


Return value 


See also 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "long" 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. For this purpose, 
the tag status must be evaluated. 


FALSE 
An error has occurred. 


Tag statuses (Page 1598) 
Beispiel SetTagSByteStateWait (Page 1576) 
Principle of the SetTag functions (Page 1467) 
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SetTagSWordState 


Function 


Syntax 


Parameters 


Return value 


Sets the value of a tag of the data type "signed 16 bit". The status of the tag is also returned. 


BOOL SetTagSWordState(Tag Tag_Name, short value, PDWORD Ip_dwstate); 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "short" 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. For this purpose, 
the tag status must be evaluated. 


FALSE 


An error has occurred. 


See also 
Tag statuses (Page 1598) 
Beispiel SetTagSByteStateWait (Page 1576) 
Principle of the SetTag functions (Page 1467) 
SetTagWordState 
Function 
Sets the value of a tag of the data type "unsigned 16 Bit". The status of the tag is also returned. 
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Syntax 


Parameters 


Return value 


See also 


wait 


SetTagBitWait 


Function 


Syntax 


2.15 ANSI-C function descriptions 


BOOL SetTagWordState(Tag Tag_Name, WORD value, PDWORD Ip_dwstate); 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "short" 


Ip_dwstate 


Pointer to a DWORD in which the status of the tag is stored after the function has been 
completed. 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. For this purpose, 
the tag status must be evaluated. 


FALSE 
An error has occurred. 


Tag statuses (Page 1598) 
Beispiel SetTagWordStateWait (Page 1577) 
Principle of the SetTag functions (Page 1467) 


Sets the value of a tag of data type "Binary tag". The function is ended after the AS has 
acknowledged acceptance of the value. 


BOOL SetTagBitWait(Tag Tag_Name, short value); 
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Parameter 


Tag_Name 
Name of the tag 


Value 
Value of the tag in the data type "short" 


Return value 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 
An error has occurred. 


See also 
SetTagBit example (Page 1570) 
Principle of the SetTag functions (Page 1467) 
SetTagByteWait 
Function 
Sets the value of a tag of the data type "unsigned 8 Bit". The function is ended after the AS 
has acknowledged acceptance of the value. 
Syntax 
BOOL SetTagByteWait(Tag Tag_Name, BYTE value); 
Parameters 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "BYTE" 
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Return value 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 
An error has occurred. 


See also 
SetTagWord example (Page 1577) 
Principle of the SetTag functions (Page 1467) 
SetTagCharWait 
Function 
Sets the value of a tag of the data type " 8-bit text tag" or "16-bit text tag". The function is ended 
after the AS has acknowledged acceptance of the value. 
Syntax 
BOOL SetTagCharWait(Tag Tag_Name, LPSTR value); 
Parameters 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "LPSTR" 


Return value 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 
An error has occurred. 
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See also 
Principle of the SetTag functions (Page 1467) 
SetTagChar example (Page 1570) 
SetTagDoubleWait 
Function 
Defines the value of a tag of the data type "64-bit floating point value". The function is ended 
after the AS has acknowledged acceptance of the value. 
Syntax 
BOOL SetTagDoubleWait(Tag Tag_Name, double value); 
Parameters 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "double" 


Return value 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 
An error has occurred. 


See also 

SetTagFloat example (Page 1571) 

Principle of the SetTag functions (Page 1467) 
SetTagDWordWait 
Function 


Sets the value of a tag of the data type "unsigned 32 Bit". The function is ended after the AS 
has acknowledged acceptance of the value. 
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Syntax 
BOOL SetTagDWordWait(Tag Tag_Name, DWORD value); 


Parameters 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "DWORD" 


Return value 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 
An error has occurred. 


See also 
SetTagWord example (Page 1577) 
Principle of the SetTag functions (Page 1467) 
SetTagFloatWait 
Function 
Defines the value of a tag of the data type "32-bit floating point value". The function is ended 
after the AS has acknowledged acceptance of the value. 
Syntax 
BOOL SetTagFloatWait(Tag Tag_Name, float value); 
Parameters 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "float" 
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Return value 


TRUE 
The function itself has been completed without any errors. 
However, no test is made as to whether the tag could be written without errors. 


FALSE 


An error has occurred. 


See also 
SetTagFloat example (Page 1571) 
Principle of the SetTag functions (Page 1467) 
SetTagMultiWait 
Function 
The values of several tags are set in the specified format. The function is ended after the AS 
has acknowledged acceptance of the value. 
Syntax 
BOOL SetTagMultiWait(const char* pFormat....) 
Parameters 


pFormat 


Format description for all requested tags and for each tag name and value. 


Return value 


TRUE 
The function itself has been completed without any errors. 
However, no test is made as to whether the tag could be written without errors. 


FALSE 


An error has occurred. 
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See also 
Format descriptors (Page 1593) 
SetTagMultiWait example (Page 1574) 
Principle of the SetTag functions (Page 1467) 
SetTagRawWait 
Function 
Sets the value of a tag of the data type "Raw data type". The function is ended after the AS 
has acknowledged acceptance of the value. 
Syntax 
BOOL SetTagRawWait(Tag Tag_Name, BYTE pValue, DWORD size); 
Parameters 


Tag_Name 
name of the tag 


pValue 

The pointer to a byte field which contains the value of the raw data tag 
size 

Size of the byte field in bytes 


Return value 
TRUE 


The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 


An error has occurred. 


See also 
SetTagRaw example (Page 1574) 
Principle of the SetTag functions (Page 1467) 
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SetTagSByteWait 


Function 


Syntax 


Parameters 


Return value 


Sets the value of a tag of the data type "signed 8 bit". The function is ended after the AS has 
acknowledged acceptance of the value. 


BOOL SetTagSByteWait(Tag Tag_Name, signed char value); 


Tag_Name 
name of the tag 


value 
The value of the tag in the data type "signed char" 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 
An error has occurred. 


See also 
SetTagSByte example (Page 1576) 
Principle of the SetTag functions (Page 1467) 
SetTagSDWordWait 
Function 
Sets the value of a tag of the data type "signed 32 bit". The function is ended after the AS has 
acknowledged acceptance of the value. 
Syntax 
BOOL SetTagSDWordWait(Tag Tag_Name, long value); 
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Parameters 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "long" 


Return value 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 


An error has occurred. 


See also 
Principle of the SetTag functions (Page 1467) 
SetTagSByte example (Page 1576) 
SetTagSWordWait 
Function 
Sets the value of a tag of the data type "signed 16 bit". The function is ended after the AS has 
acknowledged acceptance of the value. 
Syntax 
BOOL SetTagSWordWait(Tag Tag_Name, short value); 
Parameters 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "short" 
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Return value 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 
An error has occurred. 


See also 
SetTagSByte example (Page 1576) 
Principle of the SetTag functions (Page 1467) 
SetTagValueWait 
Function 
Enables the transfer of a value in the form of a variant and sets the pointer to the value of the 
data type "Variant". The function is ended after the AS has acknowledged acceptance of the 
value. 
Syntax 
BOOL SetTagValueWait(_PDM_VARKEY IpdmVarKey, LPVARIANT IpdmValue, PPWORD 
dwState, LPCMN_ERROR IpdmError); 
Parameters 
IpdmVarKey 
Pointer to a structure of the data type "DM_VARKEY" 
IpdmValue 
Pointer to the value of data type "Variant". A description of the data type VARIANT can be 
found in the associated documentation. 
dwState 
Tag status which is returned after the function has been run. 
IpdmError 
Pointer to the structure which contains the error description 
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Return value 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 
An error has occurred. 


See also 
Structure definition CMN_ERROR (Page 1601) 
Tag statuses (Page 1598) 
Structure definition DM_VAR_UPDATE_STRUCT (Page 1603) 
Structure definition DM_VARKEY (Page 1605) 
Principle of the SetTag functions (Page 1467) 
SetTagWordWait 
Function 
Sets the value of a tag of the data type "unsigned 16 Bit". The function is ended after the AS 
has acknowledged acceptance of the value. 
Syntax 
BOOL SetTagWordWait(Tag Tag_Name, WORD value); 
Parameters 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "WORD" 


Return value 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 
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See also 


SetTagBit 


Function 


Syntax 


Parameters 


Return value 


See also 


1500 


FALSE 
An error has occurred. 


SetTagWord example (Page 1577) 
Principle of the SetTag functions (Page 1467) 


Sets the value of a tag of data type "Binary tag”. 


BOOL SetTagBit(Tag Tag_Name, short int value); 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "short int" 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 
An error has occurred. 


Principle of the SetTag functions (Page 1467) 
SetTagBit example (Page 1570) 
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SetTagByte 


Function 


Syntax 


Parameters 


Return value 


See also 


SetTagChar 


Function 


Parameter 


2.15 ANSI-C function descriptions 


Sets the value of a tag of the data type "unsigned 8 Bit". 


BOOL SetTagByte(Tag Tag_Name, BYTE value); 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "BYTE" 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 


An error has occurred. 


SetTagWord example (Page 1577) 
Principle of the SetTag functions (Page 1467) 


Sets the value of a tag of the data type " 8-bit text tag" or "16-bit text tag”. 


Tag_Name 
Name of the tag 
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Value 
Value of the tag in the data type "LPSTR" 


Return value 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 
An error has occurred. 


See also 

SetTagChar example (Page 1570) 

Principle of the SetTag functions (Page 1467) 
SetTagDateTime 
Function 

Sets the value of a tag of data type "Date/Time". 
Syntax 

BOOL SetTagDateTime(Tag Tag_Name, SYSTEMTIME value); 
Parameter 


Tag_Name 
Name of the tag 


value 
Value of the tag in the data type "Date/Time". 


Return value 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 
An error has occurred. 
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SetTagDouble 


Function 


Syntax 


Parameters 


Return value 


See also 


SetTagDWord 


Function 


Syntax 


2.15 ANSI-C function descriptions 


Defines the value of a tag of the data type "64-bit floating point value". 


BOOL SetTagDouble(Tag Tag_Name, double value); 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "double" 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 


An error has occurred. 


SetTagFloat example (Page 1571) 


Principle of the SetTag functions (Page 1467) 


Sets the value of a tag of the data type "unsigned 32 Bit". 


BOOL SetTagDWord(Tag Tag_Name, DWORD value); 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 1503 


ANSI-C for Creating Functions and Actions 


2.15 ANSI-C function descriptions 


Parameters 


Return value 


See also 


SetTagFloat 


Function 


Syntax 


Parameters 
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Tag_Name 
name of the tag 


value 
Value of the tag in the data type "DWORD" 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 


An error has occurred. 


SetTagWord example (Page 1577) 
Principle of the SetTag functions (Page 1467) 


Defines the value of a tag of the data type "32-bit floating point value". 


BOOL SetTagFloat(Tag Tag_Name, float value); 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "float" 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


ANSI-C for Creating Functions and Actions 


Return value 


See also 


SetTagRaw 


Function 


Syntax 


Parameters 


Return value 


2.15 ANSI-C function descriptions 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 


An error has occurred. 


SetTagFloat example (Page 1571) 
Principle of the SetTag functions (Page 1467) 


Sets the value of a tag of the data type "Raw data type". 


BOOL SetTagRaw(Tag Tag_Name, BYTE* pValue, DWORD size); 


Tag_Name 
name of the tag 


pValue 
The pointer to a byte field which contains the value of the raw data tag 


size 
Size of the byte field in bytes 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 
An error has occurred. 
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See also 


SetTagSByte 


Function 


Syntax 


Parameters 


Return value 


See also 


SetTagSDWord 


Function 


1506 


SetTagRaw example (Page 1574) 
Principle of the SetTag functions (Page 1467) 


Sets the value of a tag of the data type "signed 8 bit". 


BOOL SetTagSByte(Tag Tag_Name, signed char value); 


Tag_Name 
name of the tag 


value 
The value of the tag in the data type "signed char" 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 


An error has occurred. 


SetTagSByte example (Page 1576) 
Principle of the SetTag functions (Page 1467) 


Sets the value of a tag of the data type "signed 32 bit". 
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Syntax 


Parameters 


Return value 


See also 


SetTagSWord 


Function 


Syntax 


Parameters 


2.15 ANSI-C function descriptions 


BOOL SetTagSDWord(Tag Tag_Name, long value); 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "long" 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 
An error has occurred. 


SetTagSByte example (Page 1576) 
Principle of the SetTag functions (Page 1467) 


Sets the value of a tag of the data type "signed 16 bit". 


BOOL SetTagSWord(Tag Tag_Name, short value); 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "short" 
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Return value 


See also 


SetTagValue 


Function 


Syntax 


Parameters 


1508 


size 
Size of the byte field in bytes 


TRUE 
The function itself has been completed without any errors. 


However, no test is made as to whether the tag could be written without errors. 


FALSE 
An error has occurred. 


SetTagSByte example (Page 1576) 
Principle of the SetTag functions (Page 1467) 


Enables the transfer of a value in the form of a variant and sets the pointer to the value of the 
data type "Variant". 


BOOL SetTagValue(L-PDM_VARKEY IpdmVarkKey, LPVARIANT lpdmValue, PDWORD 
dwState, LPCMN_ERROR IpdmError); 


IpdmVarKey 
Pointer to a structure of the data type "DM_VARKEY" 


IpdmValue 

Pointer to the value of data type "Variant". A description of the data type VARIANT can be 
found in the associated documentation. 

dwState 

Tag status which is returned after the function has been run. 


IpdmError 
Pointer to the structure which contains the error description 
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Return value 


See also 


SetTagWord 


Function 


Syntax 


Parameters 


Return value 


2.15 ANSI-C function descriptions 


TRUE 
The function itself has been completed without any errors. 
However, no test is made as to whether the tag could be written without errors. 


FALSE 
An error has occurred. 


Principle of the SetTag functions (Page 1467) 

Structure definition CMN_ERROR (Page 1601) 

Tag statuses (Page 1598) 

Structure definition DM_VAR_UPDATE_STRUCT (Page 1603) 
Structure definition DM_VARKEY (Page 1605) 


Sets the value of a tag of the data type "unsigned 16 Bit". 


BOOL SetTagWord(Tag Tag_Name, WORD value); 


Tag_Name 
name of the tag 


value 
Value of the tag in the data type "WORD" 


TRUE 
The function itself has been completed without any errors. 
However, no test is made as to whether the tag could be written without errors. 


FALSE 
An error has occurred. 
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See also 


2.15.3.6 


SetTagWord example (Page 1577) 
Principle of the SetTag functions (Page 1467) 


WinCC 


WinCC - short description 


The functions of the WinCC group allow to define various setting in Runtime. 


The functions of the System subgroup can be used to influence WinCC Runtime. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


system 

DeactivateRTProject 

Function 
Deactivates the activated project. 
Note 
If Runtime is exited on a server or client this applies only to the respective computer. 
An activated project for which the WinCC Explorer has not been started must be closed with 
the internal function "ExitWinCC". 
If the activated project was exited with the internal function "DeactivateRTProject" the WinCC 
project remains open in the background. To close this project, the WinCC Explorer must be 
opened and then be closed by means of the menu commands "File" > "Exit". 

Syntax 


Return value 


1510 


BOOL DeactivateRTProject(); 


TRUE 
The function has been completed without any errors. 
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See also 


ExitWinCC 


Function 


Syntax 


Return value 


See also 


2.15 ANSI-C function descriptions 


FALSE 
An error has occurred. 


DeactivateRTProject example (Page 1517) 


Deactivates Runtime and exits WinCC on the computer executing the function. 


Note 
If Runtime is exited on a server or client this applies only to the respective computer. 


An activated project for which the WinCC Explorer has not been started must be closed with 
the internal function "ExitWinCC". 


If the activated project was exited with the internal function "DeactivateRTProject" the WinCC 
project remains open in the background. To close this project, the WinCC Explorer must be 
opened and then be closed by means of the menu commands "File" > "Exit". 


BOOL ExitWinCC (); 


TRUE 
The function has been completed without any errors. 


FALSE 
An error has occurred. 


ExitWinCC example (Page 1517) 
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GetLanguage 


Function 


Determines the current Runtime language. 


Syntax 
DWORD GetLanguage(); 


Return value 


The current Runtime language with the associated language identifier is returned. 


Note 


You can find a comprehensive "Language code" table in the "Basic Principles of VBScript" 
documentation under the index entry "Language code". 


See also 
GetLanguage example (Page 1525) 


InquireLanguage 


Function 

Determines all languages configured in the text library for the runtime. 

Use dWCount to specify where the number of determined language IDs is to be stored. 
Syntax 

DWORD* InquireLanguage(DWORD* dwCount); 
Parameters 


dwCount 
Pointer to the number of determined language IDs 
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Return value 


See also 


SetLanguage 


Function 


Syntax 


Parameters 


Return value 


See also 


2.15 ANSI-C function descriptions 


The configured languages with the associated language identifiers are returned. 


Note 


You can find a comprehensive "Language code" table in the "Basic Principles of VBScript" 
documentation under the index entry "Language code". 


InquireLanguage example (Page 1557) 


Changes the language setting in Runtime. 


BOOL SetLanguage(DWORD dwLocalelD); 


dwLocalelD 
Language ID of the language to be set 


TRUE 
The function has been completed without any errors. 


FALSE 


An error has occurred. 


Language ID (Page 1596) 
SetLanguage example (Page 1565) 
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FillDiagnoselnTags 


Function 


Syntax 


Parameters 


Activates or deactivates the storage of diagnostic information in tags. 


As filling the tags is an additional load for the system, it should only be activated temporarily 
for diagnostic information. 


void FillDiagnoselnTags(BOOL bfill); 


bFill 
Storage of diagnostic information in tags on/off 


TRUE Activate supply of diagnostic tags 
FALSE Deactivate supply of diagnostic tags 


Diagnostic tags of GlobalScript 


@SCRIPT_COUNT_TAGS 

This tag contains the current number of tags requested via Script. 
@SCRIPT_COUNT_REQUEST_IN_QUEUES 

This tag contains the current number of jobs. 
@SCRIPT_COUNT_ACTIONS_IN_QUEUES 


This tag contains the current number of actions. 


GetServerTagPrefix 


Function 


1514 


To be able to access tags of the respective server from a WinCC client in a distributed system, 
the tag names must be supplemented with the server prefix. 


If the tags are accessed by means of the functions GetTagxx or SetTagxx, the required addition 
is made by the script control. 


If WinCC API functions are used for accessing, the tag names have to be supplemented by 
the user. The GetServer TagPrefix function provides the required prefixes. 


One pointer each of the "char" type to ServerPrefix, TagPrefix and WindowPrefix is returned. 


The user must neither change the memory (also no strcat) nor release it. 
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Syntax 


Parameters 


See also 


TraceText 


Function 


Syntax 


Parameters 


2.15 ANSI-C function descriptions 


void GetServerTagPrefix(char** ppszServerPrefix, char** ppszTagPrefix, char** 
ppszWindowPrefix); 


ppszServerPrefix 
Pointer to a pointer referring to the server prefix 


ppszTagPrefix 
Pointer to a pointer referring to the tag prefix 


ppszWindowPrefix 
Pointer to a pointer referring to the window prefix 


GetServerTagPrefix example (Page 1538) 


The value defined in <Parameter> is recorded in APDiag if the specified diagnostic level has 
been reached. 


void TraceText(DWORD dwTraceLevel, char* pszFormat, <Parameter>); 


dwTraceLevel 
Diagnostic level 


pszFormat 
Output format (according to printf function) 
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TraceTime 


Function 


Syntax 


Parameters 


1516 


<Parameter> 
Value to be reported 


Note 


The parameterization dialog for this function provides the selection of tags, graphic objects 
and pictures. 


The value defined in <Parameter> is recorded in APDiag if the specified diagnostic level has 
been reached. 


In addition, the time since the AP start of diagnosis is output in milliseconds to enable 
performance measurements. 


void TraceTime(DWORD dwtTraceLevel, char* pszFormat, <Parameter>); 


dwTraceLevel 
Diagnostic level 


pszFormat 
Output format (according to printf function) 


<Parameter> 
Value to be reported 


Note 


The parameterization dialog for this function provides the selection of tags, graphic objects 
and pictures. 
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2.15.4 Examples 
2.15.4.1 Examles - A to G 
AcknowledgeMessage example 


{ 
//Acknowledge the AlarmLogging message which is selected 


(GetTagWord("U08i MsgNr")); 


AcknowledgeMessag 
} 


Specify the message number to be acknowledged. It is read from a tag. 


DeactivateRTProject example 


{ 


//deactivate the runtime 
DeactivateRTProject (); 


} 


This function deactivates WinCC Runtime. 


ExitWinCC example 


{ 


//exit wince 
ExitWinCcC (); 
} 


This function exits WinCC. 
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2.15.4.2 Examples - GetAlarmHigh to GetPropChar 


GetAlarmHigh example 


{ 

double dAlarmHigh; 

//Get the Alarm High Limit 

dAlarmHigh = GetAlarmHigh(lpszPictureName, "Barl"); 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the function GetAlarmHigh: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"Bar1" is the name of the object. 


1. Read out the upper alarm limit and temporarily store it in dAlarmHigh. 


2. Executing user-defined code for processing return values. 
GetBackColor example 


{ 


long int bk color; 


//Get the background color 
bk_ color = GetBackColor(lpszPictureName, "StatischerText1") ; 


//User defined code where th 
//aser can do something with the return value 


} 
Parameters of the function GetBackColor: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"StaticText1" is the name of the object. 


1. Read out the current background color and temporarily store it in bk_color. 


2. Executing user-defined code for processing return values. 
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GetBorderStyle example 


{ 
long int lstyle; 


//Get the current border style 
lstyle = GetBorderStyle(lpszPictureName, "Rectanglel") ; 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the function GetBorderStyle: 


"IpszPictureName" is the name of the picture in which the object was configured. 


"Rectangle1" is the name of the object. 


1. Read out the current line style of the object and temporarily store it in Istyle. 


2. Executing user-defined code for processing return values. 


GetFilling example 
{ 
BOOL bfilling; 


//Get the actual state of dynamic filling 
bfilling = GetFilling(lpszPictureName, "Rectanglel"); 


if (bfilling) 
{ 
// User defined code if th 
// dynamic filling is activated 


} 
Else 
{ 
// User defined code if th 
// daynamic filling is deactivated 


Parameters of the function GetFilling: 


"IpszPictureName" is the name of the picture in which the object was configured. 
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"Rectangle1" is the name of the object. 


1. Read out whether dynamic filling is activated or not and temporary store in bfilling. 


2. Executing user-defined code, depending on the return value of the function. 


GetFillinglndex example 


{ 


long int filling index; 


//Get the actual filling index of the object 
filling index = GetFillingIndex(lpszPictureName, "Rectanglel") ; 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the function GetFillinglndex: 


"IpszPictureName" is the name of the picture in which the object was configured. 


"Rectangle1" is the name of the object. 


1. Read out the current fill level of the object and temporarily store it in filling_index. 


2. Executing user-defined code for processing return values. 
GetFillStyle example 


{ 
long int lstyle; 


//Get the current fill style 
lstyle = GetFillStyle(lpszPictureName, "Rectanglel") ; 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the function GetFillStyle: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"Rectangle1" is the name of the object. 
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1. Read out the current fill pattern of the object and temporarily store it in Istyle. 


2. Executing user-defined code for processing return values. 


GetFlashBackColor example 


{ 
BOOL bflash_col; 


//Get if the flashing is on or off 
bflash_col = GetFlashBackColor (lpszPictureName, "Group1") ; 


if (bflash_col) 

{ 
// User defined code if th 
// flashing is activated 


} 
Else 


{ 


// User defined code if th 
// flashing is deactivated 


Parameters of the function GetFlashBackColor: 


"IpszPictureName" is the name of the picture in which the object was configured. 


"Group1" is the name of the object. 


1. Read out whether flashing of the background color is activated or not and temporary store 


in bflash_col. 


2. Executing user-defined code, depending on the return value of the function. 


GetFlashBackColorOn example 


{ 


long int flashcol_on; 


//Get the BackFlashColor 
flashcol_ on = GetBackFlashColorOn(lpszPictureName, "Group1"); 


//User defined code where th 
//aser can do something with the return value 


} 
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Parameters of the GetBackFlashColorOn function: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"Group1" is the name of the object. 


1. Read out the background flash color for the "On" status of the obvject and and temporarily 
store it in flashcol_on. 


2. Executing user-defined code for processing return values. 


GetFlashRateFlashPic example 


{ 


long 1FlashRate; 


//Get the flashrate 


lFlashRate 


GetFlashRateFlashPic(lpszPictureName, "StatusDisplayl"); 


//User defined code where th 
//aser can do something with the return value 


} 


1522 


Parameters of the GetFlashRateFlashPic function: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"Status display1" is the name of the object. 


1. Read out the flash frequency of the object and temporarily store it in IFlashRate. 


2. Executing user-defined code for processing return values. 
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GetFocus example 


{ 
char* pszValue = NULL; 
char szValue[ MAX PATH+1]; 


//Get the Object which has the focus 
pszValue = Get_Focus(); 


//Copy the string 
if (pszValue != NULL) 
{ 
strncpy(szValue,pszValue, MAX PATH); 
} 
//User defined code where th 
//aser can do something with the return value 


} 


2.15 ANSI-C function descriptions 


1. Read out on which object the focus is and temporarily store in pszValue. 


2. If a valid value has been returned, store the return value of the function in the local string 
szValue. A maximum of _MAX_PATH characters is stored. 


3. Executing user-defined code for processing return values. 


GetFontBold example 


{ 
BOOL bbold; 


//Get if the text is bold 


bbold = GetFontBold(lpszPictureName, "StaticTextl1") ; 


if (bbold) 

{ 
// User defined code if th 
// font is bold 


} 

Else 

{ 
// User defined code if th 
// font is not bold 


Parameters of the GetBackColor function 
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"IpszPictureName" is the name of the picture in which the object was configured. 


"StaticText1" is the name of the object. 


1. Read out whether the text is in bold or not and temporarily store in bbold. 


2. Executing user-defined code, depending on the return value of the function. 


GetFontSize example 


{ 


long int fontsize; 


//Get the actual Font size 
fontsize = GetFontSize (lpszPictureName,"StaticText1"); 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the GetFontSize function: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"StaticText1" is the name of the object. 


1. Read out the current font size and temporarily store it in fontsize. 


2. Executing user-defined code for processing return values. 


GetHeight example 


{ 
long lHeight; 


//Get the height of the object 
lHeight = GetHeight (lpszPictureName, "WinCCLogo") ; 


//User defined code where th 
//aser can do something with the return value 


} 
Parameters of the GetHeight function: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"WinCCLogo" is the name of the object. 
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1. Read out the current height of the object and temporarily store it in IHeight. 


2. Executing user-defined code for processing return values. 


GetHiddenInput example 


{ 
BOOL bHiddenInput; 


//Get the state of hidden input 
bHiddenInput = GetHiddenInput (lpszPictureName, "IOField1"); 


if (bHiddenInput) 

{ 
// User defined code if th 
// hidden input is activated 


} 

Else 

{ 
// User defined code if th 
// hidden input is activated 


Parameters of the GetHiddenInput function: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"l|OField1" is the name of the object. 


1. Read out whether the text is in bold or not and temporarily store in bHiddenInput. 


2. Executing user-defined code, depending on the return value of the function. 


GetLanguage example 


{ 
DWORD rt_language; 


//Get the current language 
rt_language = GetLanguage (); 


//User defined code where th 
//aser can do something with the return value 


} 
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1. Read out the current Runtime language and temporarily store it in rt_language. 


2. Executing user-defined code for processing return values. 


GetLeft example 


{ 
long 1Pos; 


//Get the x-position of the object 
1Pos = GetLeft (lpszPictureName, "WinCCLogo") ; 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the GetLeft function: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"WinCCLogo" is the name of the object. 


1. Read out the current X position of the object and temporarily store it in IPos. 


2. Executing user-defined code for processing return values. 
GetLink example 


{ 
LINKINFO linkinfo; 


//Get the linked Tag 
GetLink (lpszPictureName, "Barl","Process", &linkinfo) ; 


// linkinfo.szLinkName is the tag name 
// linkinfo.dwCycle is the update cycl 
// linkinfo.LinkType is the type of the connection 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the GetLink function: 


"IpszPictureName" is the name of the picture in which the object was configured. 
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"Bar1" is the name of the object. 
"Process" is the property connected to a tag. 


"&linkinfo" is the address of the linkinfo structure. 


1. Fills the passed linkinfo structure with the tag connection information. 


2. Executing user-defined code, depending on the return value of the function. 


GetLinkedVariable example 


{ 
char* pszVarName = NULL; 
char szVarName[ MAX PATH+1]; 


//Get the TagName 
pszVarName = GetLinkedVariable("gs_stand_graph_00","StaticText6","Visible") ; 


//Copy the string 
if (stremp (pszVarName,"")!= 0) 
{ 
strncpy(szVarName,pszVarName, MAX PATH); 
} 
else printf("Attribute 'visible' is not made dynamic\r\n") ; 
} 
//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the GetLinkedVariable function: 
"gs_stand_graph_00" is the name of the picture in which the object was configured. 
"StaticText6" is the name of the object. 


"Visible" is the property connected to a tag. 


1. Temporarily store the return value of the GetLinkedVariable function in pszVarName. 


2. If a valid value has been returned, store the return value in szVarName. A maximum of 
_MAX_PATH characters is stored. 


3. Executing user-defined code for processing return values. 
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GetLocalPicture example 


{ 
char* pszPicName = NULL; 
char szPicName[ MAX PATH+1]; 


//Get the Local Picture 


pszPicName = GetLocalPicture (lpszPictureName) ; 


//Copy the string 
if (pszPicName != NULL) 
{ 
strncpy(szPicName,pszPicName, MAX PATH); 
} 
//User defined code where th 
//aser can do something with the return value 


1. Temporarily store the return value of the GetLocalPicture function in pszPicName. 


2. If a valid value has been returned, store the return value in szPicName. A maximum of 


_MAX_PATH characters is stored. 


3. Executing user-defined code for processing return values. 


GetMarker example 


{ 
BOOL bmarker; 


//Get the state of the Marker 
bmarker = GetMarker(lpszPictureName, "Barl"); 


if (omarker) 

{ 
// User defined code if th 
// marker is activated 


} 
Else 


{ 


// User defined code if th 
// marker is deactivated 


Parameters of the GetMarker function: 


"IpszPictureName" is the name of the picture in which the object was configured. 
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"Bar1" is the name of the object. 


1. Read out whether the marker is displayed or not and temporarily store in bmarker. 


2. Executing user-defined code, depending on the return value of the function. 


GetOutputValueDouble example 


{ 
double doutput; 


//Get the output value of IO Field 1 
doutput = GetOutputValueDouble (lpszPictureName,"IOField1") ; 


//User defined code where th 
//aser can do something with the return value 


} 
Parameters of the GetOutputValueDouble function: 


"IpszPictureName" is the name of the picture in which the object was configured. 


"l|OField1" is the name of the object. 


1. Read out the output value and temporarily store it in doutput. 


2. Executing user-defined code for processing return values. 
GetParentPicture example 


{ 
char* pszPicName = NULL; 
char szPicName[ MAX PATH+1]; 


//Get the parent picture 
pszPicName = GetParentPicture(lpszPictureName) ; 


//Copy the string 
if (pszPicName != NULL) 
{ 
strncpy(szPicName,pszPicName, MAX PATH); 
} 
//User defined code where th 
//aser can do something with the return value 


} 
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1. Temporarily store the return value of the GetParentPicture function in pszPicName. 


2. If a valid value has been returned, store the return value in szPicName. A maximum of 
_MAX_PATH characters is stored. 


3. Executing user-defined code for processing return values. 
GetPictureDown example 


{ 
char* pszPicName = NULL; 
char szPicName[ MAX PATH+1]; 


//Get the current picture name 
pszPicName = GetPictureDown (lpszPictureName, "Roundbuttonl") ; 


if (pszPicName != NULL) 

{ 

//Copy the string 
strncpy(szPicName,pszPicName, MAX PATH); 

} 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the GetPictureDown function: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"RoundButton1" is the name of the object. 


1. Read out the picture name of the picture displayed in round button 1 and temporarily store 
it in pszPicName. 


2. If a valid value has been returned, store the return value of the function in the local string 
szPicName. A maximum of _MAX_PATH characters is stored. 


3. Executing user-defined code for processing return values. 
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GetPictureName example 


{ 
char* pszPictureName = NULL; 
char szPictureName[ MAX PATH + 1]; 


//Get the current PictureName 
pszPictureName = GetPictureName (lpszPictureName, "GraphicObject1"); 


if (pszPictureName != NULL) 

{ 

//copy the string 
strncpy(szPictureName,pszPictureName, MAX PATH); 
} 

//User defined code where th 

//aser can do something with the return value 


} 


Parameters of the GetPictureName function: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"GraphicObject1" is the name of the object. 


1. Read out the picture name of the picture displayed in graphic object 1 and temporarily store 
it in pszPictureName. 


2. Ifa valid value has been returned, store the return value of the function in the local string 
szPictureName. A maximum of _MAX_PATH characters is stored. 


3. Executing user-defined code for processing return values. 
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GetPictureUp example 


{ 
char* pszPicName = NULL; 
char szPicName[ MAX PATH+1]; 


//Get the current picture name 
pszPicName = GetPictureUp(lpszPictureName, "Roundbuttonl") ; 


if (pszPicName != NULL) 

{ 

//Copy the string 
strncpy(szPicName,pszPicName, MAX PATH) ; 

} 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the GetPictureUp function: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"RoundButton1" is the name of the object. 


1. Read out the picture name of the picture displayed in round button 1 and temporarily store 
it in pszPicName. 


2. Ifa valid value has been returned, store the return value of the function in the local string 
szPicName. A maximum of _MAX_PATH characters is stored. 


3. Executing user-defined code for processing return values. 


GetPosition example 


{ 
long int lpos; 


//Get the actual position of the Slider 
lpos = GetPosition (lpszPictureName,"Controll"); 


//User defined code where th 
//aser can do something with the return value 


} 
Parameters of the GetPosition function: 
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"IpszPictureName" is the name of the picture in which the object was configured. 


"Control1" is the name of the object. 


1. Read out the current slider position and temporarily store it in Ipos. 


2. Executing user-defined code for processing return values. 


GetPropBOOL example 


{ 
BOOL bProp; 


//Get the property Visible 
bProp = GetPropBOOL("gs_ graph eafield","IOField1","Visible") ; 


if (bProp) 

{ 
// User defined code if th 
// object is visible 


} 

else 

{ 
// User defined code if th 
// object is not visible 


Parameters of the GetVisible function: 
"IpszPictureName" is the name of the picture in which the object was configured. 
"|OField1" is the name of the object. 


"Visible" is the object property. 


1. Read out whether the object is visible or not and temporarily store in bProp. 


2. Executing user-defined code, depending on the return value of the function. 
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GetPropChar example 


{ 
char* pszProp = NULL; 
char szProp[14]; 


//Get the property Tooltiptext 
pszProp = GetPropChar("lpszPictureName", "EAFeld1", "Tooltiptext") ; 


if (pszProp != NULL) 

{ 

//Copy the string 

strncpy(szProp,pszProp,13) ; 

} 

//User defined code where th 

//aser can do something with the return value 


} 


Parameters of the GetPropChar function: 
"IpszPictureName" is the name of the picture in which the object was configured. 
"|OField1" is the name of the object. 


"Tooltiptext" is the object property. 


1. Read out the tooltip text of the object and temporarily store it in pszProp. 


2. If a valid value has been returned, store the return value of the function in the local string 
szProp. A maximum of 13 characters is stored. 


3. Executing user-defined code for processing return values. 
2.15.4.3 Examples - GetRangeMax to GetWidth 
GetRangeMax example 


{ 


long int lrange; 


//Get the upper scale Limit 
lrange = GetRangeMax (lpszPictureName,"Controll"); 


//User defined code where th 
//aser can do something with the return value 


} 
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Parameters of the GetRangeMax function: 


"IpszPictureName" is the name of the picture in which the object was configured. 


"Control1" is the name of the object. 


1. Read out the current upper limit of the object and temporarily store it in lrange. 


2. Executing user-defined code for processing return values. 


GetRangeMin example 


{ 


long int lrange; 


//Get the lower scale Limit 
lrange = GetRangeMin (lpszPictureName,"Controll") ; 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the GetRangeMin function: 


"IpszPictureName" is the name of the picture in which the object was configured. 


"Control1" is the name of the object. 


1. Read out the current lower limit of the object and temporarily store it in lrange. 


2. Executing user-defined code for processing return values. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


1535 


ANSI-C for Creating Functions and Actions 
2.15 ANSI-C function descriptions 


Beispiel GetScaling 


{ 
BOOL bscaling; 


//Get the Scaling state 
bscaling = GetScaling(lpszPictureName, "Barl"); 


if (bscaling) 
{ 
// User defined code if th 
// bar object has an additional scale 


} 
Else 
{ 
// User defined code if th 
// bar object has no additional scale 


Parameters of the GetScaling function: 


"IpszPictureName" is the name of the picture in which the object was configured. 
"Bar1" is the name of the object. 


1. Read out whether the scale of the bar is displayed or not and temporarily store in bscaling. 


2. Executing user-defined code, depending on the return value of the function. 
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GetServerTagPrefix example 


{ 

char* pszServerPrefix; 

char* pszTagPrefix; 

char* pszWindowPrefix; 

int nServerPrefixLen = 0; 

int nTagPrefixLen = 0; 

int nTagLen = 0; 

char myTagName [MAX DM VAR NAME+1]; 


//Initialize the return value 
memset (myTagName,0,MAX DM VAR_NAME + 1); 


//Get the serverprefix the tagprefix and the windowprefix 
GetServerTagPrefix (&pszServerPrefix, &pszTagPrefix, &pszWindowPrefix) ; 


//TIf a serverprefix exists 
if (pszServerPrefix) 


{ 
//Get the length of the string 


nServerPrefixLen = strlen(pszServerPrefix) ; 
} 
Else 
{ 

printf ("No server prefix was returned."); 
Yeturn; 


} 


//TIf a tagprefix exists 

if (pszTagPrefix) 

{ 
//Get the length of the string 
nTagPrefixLen = strlen(pszTagPrefix) ; 


//Get the length of the tag 
nTagLen = strlen("TagName") ; 


//Check if the lenght of the 

//ServerPrefix+TagPrefixtVarName + the double points < MAX DM VAR NAM 
if (nServerPrefixLen + nTagPrefixLen + nTagLen+2 < MAX DM VAR NAME) 
{ 


Fl 


sprintf (myTagName, "%s::%3s%s",pszServerPrefix,pszTagPrefix, "TagName") ; 
//User defined code where th 
//aser can do something with the return value 


} 
Else 


{ 


printf ("The resulting string is too long."); 
return; 
} 
} 
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1. Initialize the myTagName tag. 
2. Read out the server prefix, the tag prefix and the window prefix. 
3. If no server prefix has been returned, a text ist output and the function is terminated. 


4. If a server prefix has been returned, determine its length and temporarily store it in 
nServerPrefixLen. 


5. Ifa tag prefix has been returned, determine its length and temporarily store it in TagPrefixLen. 
6. Determine the length of the tag name and temporarily store it in nVarLen. 


7. If the length permitted for tag names is exceeded a text is output and the function is 
terminated. 


8. If the length permitted for tag names is not exceeded, the tag name required for a client 
environment is compiled. 


9. Executing user-defined code for processing return values. 


GetServerTagPrefix example 


{ 

char* 
char* 
char* 


//Get 


pszServerPrefix; 
pszTagPrefix; 
pszWindowPrefix; 


serverprefix and the tagprefix 


GetServerTagPrefix (&pszServerPrefix, &pszTagPrefix, &pszWindowPrefix) ; 


//User defined code where th 
//aser can do something with the return value 
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Parameters of the GetServerTagPrefix function: 
"pszServerPrefix" is the tag which is written into the server prefix. 
"pszTagPrefix" is the tag which is written into the tag prefix. 


"pszWindowrPrefix" is the tag which is written into the window prefix. 


1. Read out the server prefix, the tag prefix and the window prefix. 
2. The pszServerPrefix tag contains the returned server prefix. 

3. The pszTagPrefix tag contains the returned tag prefix. 

4. The pszWindowPrefix tag contains the returned window prefix. 


5. Executing user-defined code for processing return values. 
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GetTagBit example 


{ 
BOOL bstate; 


//Get the current state of the tag 
bstate = GetTagBit ("gs_ tag bit"); 


if (bstate) 

{ 
// User defined code if th 
// value of the tag is true 


} 

else 

{ 
// User defined code if th 
// value of the tag is false 


Parameters of the GetTagBit function 


"gs_tag_bit" is the name of the tag. 


1. Read out the value of the tag and temporarily store it in bstate. 


2. Executing user-defined code, depending on the return value of the function. 
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GetTagBitStateQC example 


{ 

DWORD dwState; 
DWORD dwQC; 
BOOL bValue; 


dwState = OxFFFFFFFF; 


//Get the tag value 
//dwstate is the tag state 
bValue = GetTagBitStateQCWait ("gs_ tag bit", &dwState, &dwQC) ; 


//Create a string which includes the tag value 
if (bValue) 
{ 

// User defined code if th 

// value of the tag is true 


// User defined code if th 
// value of the tag is false 


Parameters of the GetTagBitStateQC function: 
"gs_tag_bit" is the name of the tag. 
"&dwState" is the address of the tags in which the tag status is to be stored. 


"&dwQC" is the address of the tag in which the quality code is to be stored. 


1. Read out the value of the tag and temporarily store it in bValue. The function puts the tag 
status in dwState and the quality code in dwQC. 


2. Executing user-defined code, depending on the return value of the function. 
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GetTagBitStateWait example 


{ 
DWORD dwstate; 
BOOL bValue; 


dwstate = OxFFFFFFFF; 


//Get the tag value 
//dwstate is the tag state 
bValue = GetTagBitStateWait ("gs tag bit", &dwstate) ; 


//Create a string which includes the tag value 
if (bValue) 
{ 

// User defined code if th 

// value of the tag is true 


} 

else 

{ 
// User defined code if th 
// value of the tag is false 


Parameters of the GetTagBitStateWait function: 
"gs_tag_bit" is the name of the tag. 


"&dwstate" is the address of the tags in which the tag status is to be stored. 


1. Read out the value of the tag and temporarily store it in bstate. The function puts the tag 
status in dwstate. 


2. Executing user-defined code, depending on the return value of the function. 
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GetTagChar example 


{ 
char* pszValue = NULL; 
char szValue[13]; 


//Get the current value of the tag 
pszValue = GetTagChar("gs_tag_char"); 


if (pszValue != NULL) 

{ 

//Copy the string 
strncpy(szValue,pszValue,12); 

} 

//User defined code where th 

//aser can do something with the return value 


} 


Parameters of the GetTagChar function: 


"gs_tag_char" is the name of the tag. 


1. Reading the value of the tag and temporarily storing in pszValue. 


2. If a valid value has been returned, store the return value of the function in the local string 
szValue. A maximum of 12 characters is stored. 


3. Executing user-defined code for processing return values. 
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GetTagCharStateQCWait example 


{ 

DWORD dwState; 

DWORD dwQC; 

char* pszRetValue = NULL; 
char szRetValue[13]; 


dwState = OxFFFFFFFF; 


//Get the tag value 
pszRetValue = GetTagCharStateQCWait ("gs _tag_ char", &dwState, &dwQC); 


if (pszRetValue != NULL) 

{ 

//Copy the string 

strncpy (szRetValue,pszRetValue,12) ; 

} 

//User defined code where th 

//aser can do something with the return value 


} 


Parameters of the GetTagCharStateQCWait function: 
"gs_tag_char" is the name of the tag. 
"&dwState" is the address of the tags in which the tag status is to be stored. 


"&dwQC" is the address of the tag in which the quality code is to be stored. 


1. Read out the value of the tag and temporarily store it in pszRetValue. The function puts the 
tag status in dwState and the quality code in dwQC. 


2. Ifa valid value has been returned, store the return value of the function in the local string 
szRetValue. A maximum of 12 characters is stored. 


3. Executing user-defined code for processing return values. 
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Beispiel GetTagCharStateWait 


{ 

DWORD dwstate; 

char szValue[11]; 

char* pszRetValue = NULL; 
char szRetValue[13]; 


dwstate = OxFFFFFFFF; 

//Get the tag value 

//dwstate is the tag state 

pszRetValue = GetTagCharStateWait ("gs tag char", &dwstate) ; 


if (pszRetValue != NULL) 

{ 

//Copy the string 

strncpy (szRetValue,pszRetValue,12) ; 

} 

//User defined code where th 

//aser can do something with the return value 


} 


Parameters of the GetTagCharStateWait function: 


"gs_tag_char" is the name of the tag. 


"&dwstate" is the address of the tags in which the tag status is to be stored. 


1. Read out the value of the tag and temporarily store it in pszRetValue. The function puts the 


tag status in dwstate. 


2. If a valid value has been returned, store the return value of the function in the local string 


szRetValue. A maximum of 12 characters is stored. 


3. Executing user-defined code for processing return values. 


GetTagFloat example 
{ 
float fValue; 


//Get the current value of the tag 
fValue = GetTagFloat ("gs _tag_ float"); 


//User defined code where th 
//aser can do something with the return value 


} 
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Parameters of the GetTagFloat function: 


"gs_tag_float" is the name of the tag. 


1. Read out the value of the tag and temporarily store it in fValue. 


2. Executing user-defined code for processing return values. 
GetTagFloatStateQCWait example 


{ 

DWORD dwState; 
DWORD dwQC; 
float fValue; 


dwState = OxFFFFFFFF; 


//Get the tag value 
fValue = GetTagFloatStateQCWait("gs_ tag float", &dwState, &dwQC); 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the GetTagFloatStateQCWait function: 
"gs_tag_float" is the name of the tag. 
"&dwState" is the address of the tags in which the tag status is to be stored. 


"&dwQC" is the address of the tag in which the quality code is to be stored. 


1. Read out the value of the tag and temporarily store it in fValue. The function puts the tag 
status in dwState and the quality code in dwQC. 


2. Executing user-defined code for processing return values. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 1545 


ANSI-C for Creating Functions and Actions 


2.15 ANSI-C function descriptions 


GetTagFloatStateWait example 


{ 
DWORD dwstate; 
float fValue; 


dwstate = OxFFFFFFFF; 

//Get the tag value 

//dwstate is the tag state 

fValue = GetTagFloatStateWait ("gs tag float", &dwstate) ; 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the GetTagFloatStateWait function: 
"gs_tag_float" is the name of the tag. 


"&dwstate" is the address of the tags in which the tag status is to be stored. 


1. Read out the value of the tag and temporarily store it in fValue. The function puts the tag 
status in dwstate. 


2. Executing user-defined code for processing return values. 
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GetTagMultiStateQCWait example 


{ 


#define DATA SIZE 5 


DWORD dwState[DATA SIZE]; 


. 


DWORD dwQC [DATA SIZE]; 


//define all Datas 


BOOL 1Valuel; 


long 1Value2 ; 
char* szValue3; 


double dblValue4 ; 


WORD 1Value5 ; 


//Set the tags 


GetTagMultiStateQCWait (dwState,dwQC, "Sdsd%s%sf%d", 
"gs tag bit", &lValuel, 
"gs_ tag SByte", &lValue2, 
"gs tag char", &szValue3, 
"gs tag float", &dblValue4, 
"gs tag word", &lValueS) ; 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the GetTagMultiStateWait function: 

"dwState" is the DWord-Array, in which the tag statuses are stored. 

"dwQC" is the DWord-Array, in which the quality codes are stored. 

"%d%d%sS%F%d" are the type descriptions of the tags to be read. 

"gs_tag_bit" is the tag to be read. 

"&lValue1" is the address of the tags in which the value of the tags gs_tag_bit should be stored. 
"gs_tag_SByte" is the tag to be read. 


"&lValue2" is the address of the tags in which the value of the tags gs_tag_SByte should be 
stored. 


The other parameters are to be handled in the same way as those described previously. 


1. Creating a DWord-Array with the required size (Number of tags). 


2. Reading and storing the values of the tags. The value of the tags gs_tag_bit is stored 
temporarily in |\Value1. The value of the tags gs_tag_SByte is stored temporarily in IValue2, 
etc. 


3. Executing user-defined code for processing return values. 
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GetTagMultiStateWait example 


{ 


#define DATA SIZE 5 


DWORD dwData[DATA SIZE]; 


x 


//define all Datas 


BOOL 1Valuel; 
long 1Value2 ; 
char* szValue3; 


double dblValue4 ; 


WORD 1Value5 ; 


//Set the tags 


GetTagMultiStateWait (dwData, "Sdsdss%sf%Sd", 


"gs tag bit", 


&lValuel, 


"gs_ tag SByte", &lValue2, 
"gs_ tag char", &szValue3, 
"gs_tag_ float", &dblValue4, 
"gs tag word", &lValueS) ; 


//User defined 


code where th 


//aser can do something with the return value 


} 
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Parameters of the GetTagMultiStateWait function: 

"dwData" is the DWord-Array, in which the tag statuses are stored. 

"%d%d%s%f%d" are the type descriptions of the tags to be read. 

"gs_tag_bit" is the tag to be read. 

"&lValue1" is the address of the tags in which the value of the tags gs_tag_bit should be stored. 
"gs_tag_SByte" is the tag to be read. 


"&lValue2" is the address of the tags in which the value of the tags gs_tag_SByte should be 
stored. 


The other parameters are to be handled in the same way as those described previously. 


1. Creating a DWord-Array with the required size (Number of tags). 


2. Reading and storing the values of the tags. The value of the tags gs_tag_bit is stored 
temporarily in |\Value1. The value of the tags gs_tag_SByte is stored temporarily in |Value2, 
etc. 


3. Executing user-defined code for processing return values. 
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GetTagMultiWait example 


DWORD dwVarlValue; 

char* szVar2Value; 

//Memory for the tag value is 

//created by teh function with SysMalloc 
double dbVar3Value; 


BOOL ok; 
ok=GetTagMultiWait ("sdsssf", "Ernie word", &dwVarlValue, 


"Ernie char", &szVar2Value, 
‘Ernie double", &dbVar3Value) ; 


printf ("Word Sd, String %s, Double %f\r\n", 
dwVarlValue, szVar2Value, dbVar3Value); 


GetTagPrefix example 


{ 
char* pszTagPrefix = NULL; 
char szTagPrefix[7]; 


//Get the current tag prefix 
pszTagPrefix = GetTagPrefix(lpszPictureName, "PicWindowl1" 


if (pszTagPrefix != NULL) 

{ 

//Copy the string 

strncpy (szTagPrefix,pszTagPrefix, 6); 

} 

//User defined code where th 

//aser can do something with the return value 


Parameters of the GetTagPrefix function: 


2.15 ANSI-C function descriptions 


\F 


"IpszPictureName" is the name of the picture in which the object was configured. 


"PictureWindow1" is the name of the object. 


1. Read out the current tag prefix of picture window 1 and temporarily store it in pszTagPrefix. 


2. If a valid value has been returned, store the return value of the function in the local string 


szTagPrefix. A maximum of 6 characters is stored 


3. Executing user-defined code for processing return values. 
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GetTagRaw example 


{ 
#define DATA SIZE 3 


BYTE byData[DATA SIZE 


, 


//Get the current values of the tag 
GetTagRaw("gs_ tag raw",byData,DATA SIZE) ; 


//Use the values received in the array byData 


} 


Parameters of the GetTagRaw function: 

"gs_tag_raw" is the name of the tag. 

"byData" is the byte array in which the values of the raw data tags will be stored. 
"DATA_SIZE" is the number of values that will be read. 


1. Reading the values of the tags and temporarily storing in byData. 


2. Executing user-defined code for processing return values. 
GetTagRawStateQCWait example 


{ 

#define DATA SIZE 3 
DWORD dwState; 
DWORD dwQC; 

BYTE byData[DATA SIZE 


dwState = OxFFFFFFFF; 


//Get the values of the tag 
GetTagRawStateQCWait ("gs tag _raw",byData,DATA SIZE, &dwState, &dwQC) ; 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the GetTfagRawStateQCWait function: 

"gs_tag_raw" is the name of the tag. 

"byData" is the byte array in which the values of the raw data tags will be stored. 
"DATA_SIZE" is the number of values that will be read. 
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"&dwState" is the address of the tags in which the tag status is to be stored. 


"&dwQC" is the address of the tag in which the quality code is to be stored. 


1. Reading the values of the tags and temporarily storing in byData. 


2. Executing user-defined code for processing return values. 


GetTagRawStateWait example 


{ 

#define DATA SIZE 3 
DWORD dwstate; 

BYTE byData[DATA SIZE ; 
char szValue[11]; 


//Load dwState with default values 
dwstate = OxFFFFFFFF; 


//Get the values of the tag 
//dwstate is the tag state 
GetTagRawStateWait ("gs tag _raw",byData,DATA SIZE, &dwstate) ; 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the GetTagRawStateWait function: 

"gs_tag_raw" is the name of the tag. 

"byData" is the byte array in which the values of the raw data tags will be stored. 
"DATA_SIZE" is the number of values that will be read. 


"&dwstate" is the address of the tags in which the tag status is to be stored. 


1. Reading the values of the tags and temporarily storing in byData. 


2. Executing user-defined code for processing return values. 
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GetTagSByte example 


{ 
long 1Value; 


//Get the current value of the tag 
lValue = GetTagSByte("gs_tag_ SByte"); 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the GetTagSByte function: 


"gs_tag_SByte" is the name of the tag. 


1. Read the value of the tag and temporarily store it in Value. 


2. Executing user-defined code for processing return values. 
GetTagSByteStateQCWait example 


{ 

DWORD dwState; 
DWORD dwQC; 
long 1Value; 


dwState = OxFFFFFFFF; 


//Get the tag value 
lValue = GetTagSByteStateQCWait ("gs tag SByte", &dwState, &dwQC); 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the GetTagSByteStateQCWait function: 
"gs_tag_SByte" is the name of the tag. 
"&dwState" is the address of the tags in which the tag status is to be stored. 


"&dwQC" is the address of the tag in which the quality code is to be stored. 


1. Read the value of the tag and temporarily store it in |\Value. The function puts the tag status 
in dwState and the quality code in dwQC. 


2. Executing user-defined code for processing return values. 
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GetTagSByteStateWait example 


{ 
DWORD dwstate; 
long 1Value; 


dwstate = OxFFFFFFFF; 

//Get the tag value 

//dwstate is the tag state 

lValue = GetTagSByteStateWait ("gs tag SByte", &dwstate) ; 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the GetTagSByteStateWait function: 
"gs_tag_SByte" is the name of the tag. 


"&dwstate" is the address of the tags in which the tag status is to be stored. 


1. Read the value of the tag and temporarily store it in |\Value. The function puts the tag status 
in dwstate. 


2. Executing user-defined code for processing return values. 


GetTagWord example 


{ 
WORD wValue; 


//Get the current value of the tag 
wValue = GetTagWord("gs_ tag word"); 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the GetTagWord function: 


"gs_tag_word" is the name of the tag. 


1. Read out the value of the tag and temporarily store it in wValue. 


2. Executing user-defined code for processing return values. 
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GetTagWordStateQCWait example 


{ 

DWORD dwState; 
DWORD dwQC; 
WORD wValue; 


dwState = OxFFFFFFFF; 


//Get the tag value 
wValue = GetTagWordStateQCWait ("gs_tag_ word", &dwState, &dwQC); 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the GetTagWordStateQCWait function: 
"gs_tag_word" is the name of the tag. 
"&dwState" is the address of the tags in which the tag status is to be stored. 


"&dwQC" is the address of the tag in which the quality code is to be stored. 


1. Read out the value of the tag and temporarily store it in wValue. The function puts the tag 
status in dwState and the quality code in dwQC. 


2. Executing user-defined code for processing return values. 
GetTagWordStateWait example 


{ 
DWORD dwstate; 
WORD wValue; 


dwstate = OxFFFFFFFF; 

//Get the tag value 

//dwstate is the tag state 

wValue = GetTagWordStateWait ("gs _tag_ word", &dwstate) ; 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of then GetTagWordStateWait function: 
"gs_tag_word" is the name of the tag. 


"&dwstate" is the address of the tags in which the tag status is to be stored. 
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1. Read out the value of the tag and temporarily store it in wValue. The function puts the tag 


status in dwstate. 


2. Executing user-defined code for processing return values. 


GetText example 


{ 
char* pszValue = NULL; 
char szValue[13]; 


//Get the Text which is actually set 


pszValue = GetText (lpszPictureName,"StaticTextl"); 


if (pszValue != NULL) 

{ 

//Copy the string 
strncpy(szValue,pszValue,12); 

} 

//User defined code where th 

//aser can do something with the return value 


} 


Parameters of the GetText function: 


"IpszPictureName" is the name of the picture in which the object was configured. 


"StaticText1" is the name of the object. 


1. Read out the text in the object StaticText1 and temporarily store it in pszValue. 


2. If a valid value has been returned, store the return value of the function in the local string 


szValue. A maximum of 12 characters is stored. 


3. Executing user-defined code for processing return values. 


GetTop example 


{ 
long 1Pos; 


//Get the y-Position of the Object 
1Pos = GetTop(lpszPictureName, "WinCCLogo") ; 


//User defined code where th 
//aser can do something with the return value 


} 
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Parameters of the GetTop function: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"WinCCLogo" is the name of the object. 


1. Read out the current Y position of the object and temporarily store it in IPos. 


2. Executing user-defined code for processing return values. 


GetVisible example 


{ 
BOOL bVisible; 


//Get the visibility 
bVisible = GetVisible(lpszPictureName, "GraphicObject1"); 


if (bVisible) 

{ 
// User defined code if th 
// object is visible 


} 

else 

{ 
// User defined code if th 
// object is not visible 


Parameters of the GetVisible function: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"GraphicObject1" is the name of the object. 


1. Read out whether the object is visible or not and temporarily store in bVisible. 


2. Executing user-defined code, depending on the return value of the function. 
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GetWidth example 


{ 
long 1Width; 


//Get the width of the object 
lWidth = GetWidth(lpszPictureName, "WinCCLogo") ; 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the GetWidth function: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"WinCCLogo" is the name of the object. 


1. Read out the current width of the object and temporarily store it in Width. 


2. Executing user-defined code for processing return values. 
2.15.4.4 Examples - H to S 
InquireLanguage example 


{ 

DWORD count; 
DWORD* language; 
int i; 


//Count the installed languages 
language = InquireLanguage (&count) ; 


PLInts (“HHFHHHHEHHEEEHE HEHE HEF INQUIRE LANGUAGE ####t tt HEHE EERE EEE HE" ) 5 
//Print out the count of languages 
printf ( "\r\nCount Languages=%d\r\n", count ); 


//print out which languages are installed 
for (i=l;i<=count; itt) 

{ 

printf ("\r\n%Sd.language=%x", i, *languagett) ; 
} 

} 


1. Determine the languages configured for the runtime. In language the language IDs are 
temporarily stored. In count the number of languages is temporarily stored. 
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2. The number of determined languages is output. 


3. All determined language IDs are displayed. 


ProgramExecute example 


{ 
//start the program calc.exe 
ProgramExecute ("C:\\Winnt\\system32\\calc.exe") ; 


} 


As parameter the file is to be specified with its path. 


RPTJobPreview example 


{ 
//Start the print preview of the specified print job 


RPTJobPreview("Documentation Text Library"); 
} 
Parameters of the "RPTJobPreview" function: 


"Documentation Text Library" is the name of the print job. 


RPTJobPrint example 


{ 
//Print the specified print job out 


RPTJobPrint ("@Text library (compact)"); 
} 


Parameters of the RPTJobPrint function: 


@Text library (compact) is the name of the print job. 


SysMalloc example 


char* main(...); 

{ 

char* returnwert; 

char text[17]; 
returnwert=SysMalloc (17); 
strepy (returnwert, &text[0]; 
return returnwert; 


} 
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Examples - SetAlarmHigh to SetPropChar 


SetAlarmHigh example 


{ 


//Set the upper limit for the warning 
SetAlarmHigh (lpszPictureName,"Barl",3.0); 


} 


Parameters of the SetAlarmHigh funtion: 
"IpszPictureName" is the name of the picture in which the object was configured. 
"Bar1" is the name of the object. 


"3.0" is the value to which the upper alarm limit will be set. 


SetBackColor example 


{ 


//Set the back color blue 


SetBackColor (lpszPictureName, "StaticText1",CO_ BLUE) ; 


} 


Parameters of the SetBackColor function: 
"IpszPictureName" is the name of the picture in which the object was configured. 
"StaticText1" is the name of the object. 


"CO_BLUE" is the constant for the color "Blue". 


Note 


Instead of using the constant for the color value you may also specify the color by means of 
a hexadecimal value. 


SetBorderEndStyle example 


{ 
SetBorderl 


} 


EndStyle(lpszPictureName, "Line", (2|393216)); 
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Sets the left line end as filled arrow and the right one as filled circle. The left line end is stored 
in the two lower bytes, the right line end in the two upper bytes. The parameters are transferred 


by means of numeric values. 


Example of setting the line ends with symbolic names 


{ 
SetBorderEndStyle(lpszPictureName, "Line", (LE FULL ARROW| (LE FULL CIRCLE <<16)); 


} 


Sets the left line end as filled arrow and the right one as filled circle. The left line end is stored 
in the two lower bytes, the right line end in the two upper bytes. To address the right line end 
the symbolic designation "LE_FULL_CIRCLE" is moved by 2 bytes or 16 bit into the two upper 


bytes. 
SetBorderStyle example 


{ 
//Change the Border styl 
SetBorderStyle (lpszPictureName, "Rectanglel", 3); 


} 


Parameters of the SetBorderStyle function: 
"IpszPictureName" is the name of the picture in which the object was configured. 
"Rectangle1" is the name of the object. 


"3" is the line style which is set for the object. 


SetColorAlarmHigh example 


{ 
//Set the Color for the alarm high limit to red 


SetColorAlarmHigh (lpszPictureName, "Bar1",CO RED) ; 
} 


Parameters of the SetColorAlarmHigh function: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"Bar1" is the name of the object. 
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"CO_RED" is the constant for the color red. 


Note 
Instead of using the constant for the color value you may also specify the color by means of 


a hexadecimal value. 


Example - SetCursorMode 


{ 
//Set the Cursor Mode to Alpha cursor 


SetCursorMode (lpszPictureName, "GraphikObjekt1", FALSI 
} 


my 
a 


x 


Parameters of the SetCursorMode function: 
"IpszPictureName" is the name of the picture in which the object was configured. 
"GraphicObject1" is the name of the object. 

"FALSE" signifies: Cursor mode "Alpha-Cursor" is set. 


SetFilling example 


{ 
//Set the dynamic filling true 


SetFilling(lpszPictureName, "Rectanglel", TRUE) ; 
} 


3 
x 


Parameters of the SetFilling function: 
"IpszPictureName" is the name of the picture in which the object was configured. 
"Rectangle1" is the name of the object. 


"TRUE" means: Activating dynamic filling. 


SetFillinglndex example 


{ 
//Set the Filling of Rectanglel to 10 


SetFillingIndex(lpszPictureName, "Rectanglel",10) ; 
} 


Parameters of the SetFillinglndex function: 
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"IpszPictureName" is the name of the picture in which the object was configured. 


"Rectangle1" is the name of the object. 
"10" is the fill level which is assigned to the object. 


SetFillStyle example 


{ 
//Change the fill style 
SetFillStyle (lpszPictureName, "Rectanglel", 196617); 


} 


Parameters of the SetFillStyle function: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"Rectangle1" is the name of the object. 
"196617" is the fill pattern (brick wall) which is set for the object. 


SetFlashBackColor example 


{ 
//Set the flashing to True 
SetFlashBackColor(lpszPictureName, "Group1", TRUE) ; 


} 


. 


Parameters of the SetFlashBackColor function 
"IpszPictureName" is the name of the picture in which the object was configured. 


"Group1" is the name of the object. 
"TRUE" means: Activating flashing of the background color. 


SetFlashBackColorOn example 


{ 
//Set the Flash color for the state on to red 


SetBackFlashColorOn (lpszPictureName, "Group1",CO_R 
} 


ED) ; 


Parameters of the SetBackFlashColorOn function: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"Group1" is the name of the object. 
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"CO_Red" is the constant for the color "Red". 


Note 
Instead of using the constant for the color value you may also specify the color by means of 


a hexadecimal value. 


SetFlashRateFlashPic example 


{ 
//Set the flash rate to 0 
SetFlashRateFlashPic (lpszPictureName, "Statusdisplayl", 0); 


} 


Parameters of the SetFlashRateFlashPic function: 
"IpszPictureName" is the name of the picture in which the object was configured. 
"Status display1" is the name of the object. 


"O" is the flash frequency of the object. 


SetFocus example 


{ 
//Set the Focus on the Object Button 1 


Set_Focus (lpszPictureName, "Button1") ; 


} 


Parameters of the Set_Focus function 
"IpszPictureName" is the name of the picture in which the object was configured. 


"Button1" is the name of the object on which the focus is set. 


SetFontBold example 


{ 
//Set the displayed Text bold 
SetFontBold(lpszPictureName, "StatischerText1", TRUE 


} 


Lr 
x 


Parameters of the SetFontBold function: 
"IpszPictureName" is the name of the picture in which the object was configured. 
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"StaticText1" is the name of the object. 


"TRUE" means: The text is written in bold face. 


SetFontSize example 


{ 
//Set Font Size to 12 
SetFontSize (lpszPictureName, "StaticText1",12); 


} 


Parameters of the SetFontSize function: 
"IpszPictureName" is the name of the picture in which the object was configured. 
"StaticText1" is the name of the object. 

"12" is the font size to which the text is set. 


SetHeight example 


{ 
//Set the height of the object to 100 


SetHeight (lpszPictureName, "WinCCLogo", 100); 
} 


Parameters of the SetHeight function: 
"IpszPictureName" is the name of the picture in which the object was configured. 
"WinCCLogo" is the name of the object. 

"100" is the height to which the object is set. 


SetHiddenInput example 


{ 
//Set the hidden input true 
SetHiddenInput (lpszPictureName, "IOField1", TRUE 


} 


x 


Parameters of the SetHiddenInput function: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"l|OField1" is the name of the object. 
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"TRUE" means: Activating the hidden input. 


SetLanguage example 


{ 

//German 

SetLanguage (0x0407) ; 
} 


The Runtime language is set to German. 


SetLeft example 


{ 
//Set the x-position to 0 
SetLeft (lpszPictureName, "WinCCLogo", 0) ; 


} 


Parameters of the SetLeft function: 

"IpszPictureName" is the name of the picture in which the object was configured. 
"WinCCLogo" is the name of the object. 

"O" is the X position to which the object is set. 


SetLink example 


LINKINFO linkinfo; 


//Set the link type 
linkinfo.LinkType = 1; 


//Set the update cycl 
linkinfo.dwCycle = 0; 


//set the Structmember 
strcepy(linkinfo.szLinkName, "U08i link 00"); 


//Set the connection to the tag 
SetLink (lpszPictureName, "Bar1l","Process", &linkinfo) ; 


} 
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Parameters of the SetLink function: 

"IpszPictureName" is the name of the picture in which the object was configured. 
"Bar1" is the name of the object. 

"Process" is the property connected to a tag. 


"&linkinfo" is the address of the linkinfo structure. 


1. Set the connection type for the process property to direct connection. 
2. Set the update cycle to "Upon change". 
3. Set the tag name to UO8i_link_00. 


SetMarker example 


{ 


//Set the marker visible 
SetMarker (lpszPictureName, "Bar1", TRUE) ; 


} 


Parameters of the SetMarker function: 
"IpszPictureName" is the name of the picture in which the object was configured. 
"Bar1" is the name of the object. 


"TRUE" means: The marker is displayed. 


SetOutputValueDouble example 


//Set the output value of the IO field to 55.5 
SetOutputValueDouble (lpszPictureName, "IOField1",55.5); 
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Parameters of the SetOutputValueDouble function: 
"IpszPictureName" is the name of the picture in which the object was configured. 
"|OField1" is the name of the object. 


"55.5" is the value which is output. 
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SetPictureDown example 


{ 
//Set the picture name to activated.bmp 
SetPictureDown (lpszPictureName, "Roundbuttonl", "activated.bmp") ; 


} 


Parameters of the SetPictureDown function: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"RoundButton1" is the name of the object. 
"activated.bmp" is the picture name of the picture to be displayed in round button 1. 


SetPictureName example 


{ 
//Set the picture name cool_man.bmp 
SetPictureName (lpszPictureName, "GraphicObject1","cool_man.bmp") ; 


} 


Parameters of the SetPictureName function: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"GraphicObject1" is the name of the object. 
"cool_man.bmp" is the picture name of the picture to be displayed in graphic object 1. 


SetPictureUp example 


{ 
//Set the picture name to deactivated.bmp 
SetPictureUp (lpszPictureName, "Roundbuttonl", "deactivated.bmp") ; 


} 


Parameters of the SetPictureUp function: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"RoundButton1" is the name of the object. 
"deactivated.bmp" is the picture name of the picture to be displayed in round button 1. 
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SetPosition example 


{ 


//Set the Slider Position to 30 
SetPosition(lpszPictureName, "Controll1", 30); 


} 


Parameters of the SetPosition function: 
"IpszPictureName" is the name of the picture in which the object was configured. 
"Control1" is the name of the object. 


"30" is the position to which the slider is to be set. 


SetPropBOOL example 


{ 


//Set the visibility TRUE 
SetPropBOOL ("lpszPictureName", "EAFeld1i", "Visible", TRUE) ; 


} 


x 


Parameters of the SetVisible function: 

"IpszPictureName" is the name of the picture in which the object was configured. 
"|OField1" is the name of the object. 

"TRUE" means: The object is intended to be visible. 


SetPropChar example 


{ 


//Set the property Tooltiptext 
SetPropChar("gs_ graph eafield","IOField1", "ToolTipText","Tooltiptextl "); 


} 
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Parameters of the SetPropChar function: 

"IpszPictureName" is the name of the picture in which the object was configured. 
"l|OField1" is the name of the object. 

"Tooltiptext" is the object property. 

"Tooltiptext 1" is the value to which the property is to be set. 
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2.15 ANSI-C function descriptions 


Examples - SetRangeMax to SetWidth 


SetRangeMax example 


{ 


//Set the Upper Scale Limit 
SetRangeMax (lpszPictureName, "Controll1", 80); 


} 


Parameters of the SetRangeMax function: 
"IpszPictureName" is the name of the picture in which the object was configured. 
"Control1" is the name of the object. 


"80" is the upper limit to be assigned to the object. 


SetRangeMin example 


{ 


//Set th 


lower Scale Limit 


SetRangeMin (lpszPictureName, "Controll",0); 


} 


Parameters of the SetRangeMin function: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"Control1" is the name of the object. 


"O" is the lower limit to be assigned to the object. 


SetScaling example 


{ 


//Set the Scaling Visible 


SetScaling (lpszPictureName,"Bar1", TRUE) ; 


} 


x 


Parameters of the SetScaling function: 
"IpszPictureName" is the name of the picture in which the object was configured. 


"Bar1" is the name of the object. 


"TRUE" means: Making the scaling visible. 
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SetTagBit example 


{ 

//Set the tag to true 
SetTagBit("gs_ tag bit",TRUE); 
} 


x 


Parameters of the SetTagBit function: 
"gs_tag_bit" is the name of the tag. 
"TRUE" is the value to be written to the tag. 


Beispiel SetTagBitStateWait 


{ 
DWORD dwstate; 


//Load dwState with default values 
dwstate = OxFFFFFFFF; 

//Set the value of the tag to TRUE 
//dwstate is the tag state 
SetTagBitStateWait ("gs tag bit", TRUE, &dwstate) ; 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the SetTagBitStateWait function: 
"gs_tag_bit" is the name of the tag. 
"TRUE" is the value to be written to the tag. 


"&dwstate" is the address of the tags in which the tag status is to be stored. 


1. Setting the tags to the specified value. 


2. Executing user-defined code for processing return values. 
SetTagChar example 


{ 
//Set the tag to Example text 
SetTagChar ("gs_tag_char","Example Text"); 


} 
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Parameters of the SetTagChar function: 
"gs_tag_char" is the name of the tag. 


"Example text" is the value to be written to the tag. 


SetTagCharStateWait example 


{ 
DWORD dwstate; 


//Load dwState with default values 
dwstate = OxFFFFFFFF; 


//Set the tag to Example Text 
//dwstate is the tag state 
SetTagCharStateWait ("gs tag _char","Example Text", &dwstate) ; 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the SetTagCharStateWait function: 
"gs_tag_char" is the name of the tag. 
"Example text" is the value to be written to the tag. 


"&dwstate" is the address of the tags in which the tag status is to be stored. 


1. Setting the tags to the specified value. 


2. Executing user-defined code for processing return values. 
SetTagFloat example 


{ 

//Set the tag to 55.4711 
SetTagFloat("gs_ tag float",55.4711); 
} 


Parameters of the SetTagFloat function: 
"gs_tag_float" is the name of the tag. 


"55.4711" is the value to be written to the tag. 
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SetTagFloatStateWait example 


{ 
DWORD dwstate; 
char szValue[9]; 


//Load dwState with default values 
dwstate = OxFFFFFFFF; 


//Set the tag to 55.4711 
//dwstate is the tag state 
SetTagFloatStateWait ("gs tag float",55.4711, &dwstate) ; 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the SetTagFloatStateWait function: 
"gs_tag_float" is the name of the tag. 
"55.4711" is the value to be written to the tag. 


"&dwstate" is the address of the tags in which the tag status is to be stored. 


1. Setting the tags to the specified value. 


2. Executing user-defined code for processing return values. 
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SetTagMultiStateWait example 


{ 
#define DATA SIZE 5 
DWORD dwData[DATA SIZE]; 


x 


//define all tags 

BOOL 1Valuel; 

long 1Value2 ; 

char szValue3[_MAX PATH]; 
float 1Value4; 

char 1Value5; 


// Fill the tags with the values 
// you want to set into the WinCC tags 


//Set the WinCC tags 
SetTagMultiStateWait (dwData, "Sdsdsssfsd","gs_ tag bit", 1Valuel, 
"gs_tag SByte",1Value2, 
"gs_tag_char",szValue3, 
"gs _tag_ float", 1Value4, 
"gs_tag_word",1Value5) ; 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the SetTagMultiStateWait function: 

"dwData" is the DWord-Array, in which the tag statuses are stored. 
"%d%d%sS%F%d" are the type descriptions of the tags to be written. 
"gs_tag_bit" is the WinCC tag to be written. 

"lValue1" is the tag to whose value the WinCC tag gs_tag_bit is to be set. 
"gs_tag_SByte" is the WinCC tag to be written. 

"&lValue2" is the tag to whose value the WinCC tag gs_tag_SByte is to be set. 


The other parameters are to be handled in the same way as those described previously. 


1. Creating a DWord-Array with the required size (Number of tags). 
2. Creating tags whose values are to be written to the WinCC tags. 
3. Writing the values of the previously created and filled tags to the WinCC tags.| 


4. Executing user-defined code for processing return values. 
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SetTagMultiWait example 


BOOL ok; 


ok=SetTagMultiWait ("sdsssf", "Ernie word", 16, 
"Ernie char", "Hello World", 
"Ernie double", 55.4711); 


SetTagPrefix example 


{ 
//Set the TagPrefix to Structl. 
SetTagPrefix (lpszPictureName,"PicWindowl","Structl."); 


//Set the picture name again to update the tag prefix 
SetPictureName (lpszPictureName,"PicWindowl","gs_graph_eafield"); 


} 


Parameters of the SetTagPrefix function: 
"IpszPictureName" is the name of the picture in which the object was configured. 
"PictureWindow1" is the name of the object. 


"Struct1." is the tag prefix to be set at picture window 1. 


1. Set the tag prefix of the object "PictureWindow1" to "Struct1.". 


2. Reset the name of the picture shown in the picture window to make the tag prefix setting 
effective. 


SetTagRaw example 


{ 
#define DATA SIZE 3 


BYTE byData[DATA SIZE]; 


// Fill the Byte array with the values 
// you want to set into the raw data tag 


//Set the tag to the default values 
SetTagRaw("gs_tag_raw",byData, DATA SIZE); 


} 
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"gs_tag_raw" is the name of the tag. 


"byData" is the byte array whose values are written to the raw data tags. 
"DATA_SIZE" is the number of values that will be written. 


1. Creating a BYTE-Array with the required size (size of the raw data tag). 
2. Filling the BYTE-Array with the values to be written. 
3. Writing the values of the BYTE-Array to the raw data tag. 


SetTagRawStateWait example 


{ 
#define DATA SIZE 3 


BYTE byData[DATA SIZE ; 
DWORD dwstate; 
char szValue[9]; 


x 


//Load dwState with default values 
dwstate = OxFFFFFFFF; 


// Fill the Byte array with the values 


// you want to set into the raw data tag 


//Set the tag to the default values 
//dwstate is the tag state 


SetTagRawStateWait ("gs tag _raw",byData,DATA SIZE, &dwstate) ; 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the SetTagRawStateWait function: 


"gs_tag_raw" is the name of the tag. 


"byData" is the byte array whose values are written to the raw data tags. 
"DATA_SIZE" is the number of values that will be written. 


"&dwstate" is the address of the tags in which the tag status is to be stored. 


1. Creating a BYTE-Array with the required size (size of the raw data tag). 
2. Filling the BYTE-Array with the values to be written. 
3. Writing the values of the BYTE-Array to the raw data tag. 
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4. Executing user-defined code for processing return values. 


SetTagSByte example 


{ 

//Set the tag to 50 
SetTagSByte("gs_ tag SByte",50); 
} 


Parameters of the SetTagSByte function: 
"gs_tag_SByte" is the name of the tag. 


"50" is the value to be written to the tag. 


Beispiel SetTagSByteStateWait 


{ 
DWORD dwstate; 
char szValue[9]; 


//Load dwState with default values 
dwstate = OxFFFFFFFF; 


//Set the tag to 50 
//dwstate is the tag state 
SetTagSByteStateWait ("gs tag SByte",50, &dwstate) ; 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the SetTagSByteStateWait: 
"gs_tag_SByte" is the name of the tag. 
"50" is the value to be written to the tag. 


"&dwstate" is the address of the tags in which the tag status is to be stored. 


1. Setting the tags to the specified value. 


2. Executing user-defined code for processing return values. 
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SetTagWord example 


{ 

//Set the tag to 50 
SetTagWord("gs_tag_word",50); 
} 


Parameters of the SetTagWord function: 
"gs_tag_word" is the name of the tag. 


"50" is the value to be written to the tag. 


Beispiel SetTagWordStateWait 


{ 
DWORD dwstate; 
char szValue[9]; 


//Load dwState with default values 
dwstate = OxFFFFFFFF; 


//Set the tag to 50 
//dwstate is the tag state 
SetTagWordStateWait ("gs tag _word",50, &dwstate) ; 


//User defined code where th 
//aser can do something with the return value 


} 


Parameters of the SetTagWordStateWait funtion: 
"gs_tag_word" is the name of the tag. 
"50" is the value to be written to the tag. 


"&dwstate" is the address of the tags in which the tag status is to be stored. 


1. Setting the tags to the specified value. 


2. Executing user-defined code for processing return values. 
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SetText example 


{ 


//Set the text I 


Example Text on the StaticText field 


SetText (lpszPictureName, "StaticTextl","Example Text"); 


} 


SetTop example 


{ 


Parameters of the SetText function: 
"IpszPictureName" is the name of the picture in which the object was configured. 
"StaticText1" is the name of the object. 


"ExampleText" is the text which is to be output. 


//Set the y-position to 0 
SetTop (lpszPictureName, "WinCCLogo",140) ; 


} 


Parameters of the SetTop function: 

"IpszPictureName" is the name of the picture in which the object was configured. 
"WinCCLogo" is the name of the object. 

"140" is the Y position to which the object is set. 


SetVisible example 


{ 


//Set the Object visible 


SetVisible (lpszPictureName, "GraphicObject1", TRUE 


} 
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Parameters of the SetVisible function: 

"IpszPictureName" is the name of the picture in which the object was configured. 
"GraphicObject1" is the name of the object. 

"TRUE" means: The object is intended to be visible. 
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SetWidth example 


{ 
//Set the width of the object to 400 
SetWidth (lpszPictureName, "WinCCLogo", 400) ; 


} 


Parameters of the SetWidth function 

"IpszPictureName" is the name of the picture in which the object was configured. 
"WinCCLogo" is the name of the object. 

"400" is the width to which the object is set. 


2.15.4.7 Examples of WinCC controls 


How to add elements to a WinCC OnlineTrendControl 


Introduction 


In the following example, insert value columns with properties in an empty WinCC 
OnlineTableControl and link the columns to archive tags. 


Prerequisite 
e An archive is created in the "Tag Logging Editor" with three archive tags. 


e A"WinCC OnlineTableControl" with the name "Control2" is inserted in the process picture 
in the Graphics Designer. 


e A button is inserted in the Graphics Designer. You have configured, for example, the event 
"mouse click" with a C action and the following script for the button. 
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Example 


//enable BackColor 
SetPropBOOL(lpszPictureName, "Control2", "UseColumnBackColor", TRUE) ; 


//add new TimeColumn and assign column length 
SetPropChar(lpszPictureName, "Control2", "TimeColumnAdd", "myRefTimeColumn") ; 


SetPropWord(lpszPictureName, "Control2", "TimeColumnLength", 20); 

//add new ValueColumn and assign properties 

SetPropChar(lpszPictureName, "Control2", "ValueColumnAdd", "myValueTablel"); 
SetPropWord(lpszPictureName, "Control2", "ValueColumnProvider", 1); 
SetPropChar(lpszPictureName, "Control2", "ValueColumnTagName", "Process value archive\ 
\PDL_ ZT 1"); 

SetPropWord(lpszPictureName, "Control2", "ValueColumnBackColor", RGB(255,255,255)); 
SetPropChar(lpszPictureName, "Control2", "ValueColumnTimeColumn", "myRefTimeColumn") ; 


//add new ValueColumn and assign properties 
SetPropChar(lpszPictureName, "Control2", "ValueColumnAdd", "myValueTable2") ; 
SetPropWord(lpszPictureName, "Control2", "ValueColumnProvider", 1); 
SetPropChar(lpszPictureName, "Control2", "ValueColumnTagName", "Process value archive\ 
\PDL ZT 2"); 
SetPropWord(lpszPictureName, "Control2", "ValueColumnBackColor", RGB(0,255,255)); 
SetPropChar(lpszPictureName, "Control2", "ValueColumnTimeColumn", "myRefTimeColumn") ; 


//add new ValueColumn and assign properties 
SetPropChar(lpszPictureName, "Control2", "ValueColumnAdd", "myValueTable3") ; 
SetPropWord(lpszPictureName, "Control2", "ValueColumnProvider", 1); 
SetPropChar(lpszPictureName, "Control2", "ValueColumnTagName", "Process value archive\ 
\PDL_ ZT 3"); 
SetPropWord(lpszPictureName, "Control2", "ValueColumnBackColor", RGB(255,255,0)); 
SetPropChar(lpszPictureName, "Control2", "ValueColumnTimeColumn", "myRefTimeColumn") ; 


Result 


fa WinCC OnlineTableControl 


mM deo > yal . 
© 88 ii S| al) |S) cs 
Saree myValueTable1 _|myValueTable2_|myValueTable3 | Cid 
72 ee 1 
1113 |08.02.2010 14:15:03 22 
114 [08.02.2010 14:15:04 2 
115 [08.02.2010 14:15:04 1 
1116 |08.02.2010 14:15:05 1 
117 |08.02.2010 14:15:05 3 

1 
1 
1 


08.02.2010 14:15:06 
08.02.2010 14:15:06 
120 | 08.02.2010 14:15:07 
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How to add elements to a WinCC OnlineTrendControl 


Introduction 


In the following example you insert the Trend Window, Value Axis, Time Axis and Trends 
elements into an empty WinCC OnlineTrendControl. 


Prerequisite 
e Anarchive is created in the "Tag Logging Editor" with three archive tags. 


e A"WinCC OnlineTrendControl" with the name "Control2" is inserted in the process picture 
in the Graphics Designer. 


e A button is inserted in the Graphics Designer. You have configured, for example, the event 
"mouse click" with a C action and the following script for the button. 
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Example 


//create reference to new window, time and value axis 
SetPropChar(lpszPictureName, "Control2", "TrendWindowAdd", "myWindow") ; 
lpszPictureName, "Control2", "TimeAxisAdd", "myTimeAxis") ; 
lpszPictureName, "Control2", "ValueAxisAdd", "myValueAxis") ; 


//assign time and value axis to the window 
SetPropChar(lpszPictureName, "Control2", "TimeAxisTrendWindow", "myWindow") ; 
SetPropChar(lpszPictureName, "Control2", "ValueAxisTrendWindow", "myWindow") ; 


//add new trend and assign properties 
SetPropChar(lpszPictureName, "Control2", "TrendAdd", "myTrendl1") ; 
PropWord(lpszPictureName, "Control2", "TrendProvider", 1); 
PropChar(lpszPictureName, "Control2", "TrendTagName", "Process value archive\ 


(lpszPictureName, "Control2", "TrendColor",  RGB(255,0,0)); 
SetPropChar(lpszPictureName, "Control2", "TrendTrendWindow", "myWindow") ; 

( 

( 


lpszPictureName, "Control2", "TrendTimeAxis", "myTimeAxis") ; 
lpszPictureName, "Control2", "TrendValueAxis", "myValueAxis"); 


//add new trend and assign properties 
SetPropChar(lpszPictureName, "Control2", "TrendAdd", "myTrend2") ; 
SetPropWord(lpszPictureName, "Control2", "TrendProvider", 1); 
SetPropChar(lpszPictureName, "Control2", "TrendTagName", "Process value archive\ 


lpszPictureName, "Control2", "TrendColor", RGB(0,255,0)); 
lpszPictureName, "Control2", "TrendTrendWindow", "myWindow") ; 
lpszPictureName, "Control2", "TrendTimeAxis", "myTimeAxis") ; 
lpszPictureName, "Control2", "TrendValueAxis", "myValueAxis") ; 


//add new trend and assign properties 
SetPropChar(lpszPictureName, "Control2", "TrendAdd", "myTrend3") ; 
SetPropWord(lpszPictureName, "Control2", "TrendProvider", 1); 
PropChar(lpszPictureName, "Control2", "TrendTagName", "Process value archive\ 


lpszPictureName, "Control2", "TrendColor", RGB(0,0,255)); 
lpszPictureName, "Control2", "TrendTrendWindow", "myWindow") ; 
lpszPictureName, "Control2", "TrendTimeAxis", "myTimeAxis"); 
lpszPictureName, "Control2", "TrendValueAxis", "myValueAxis") ; 


2.15.4.8 Examples - Obsolete functions 


AXC_OnBtnMsgFirst example 


{ 

// jump to the first message in the WinCC Alarm Control 
AXC_OnBtnMsgFirst("gs_alarm_00","Controll") ; 

} 
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Parameters of the AXC_OnBtnMsgFirst function: 
"gs_alarm_00" is the name of the picture in which WinCC Alarm Control was configured. 


Control1 is the object name of the WinCC Alarm Control. 


Note 
Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 


well. 


Beispiel AXC_OnBtnMsgLast 


{ 
// jump to the last message in the WinCC Alarm Control 


AXC_OnBtnMsgLast ("gs alarm_00","Controll"); 
} 


Parameters of the AXC_OnBtnMsgLast function: 
"gs_alarm_00" is the name of the picture in which WinCC Alarm Control was configured. 


Control1 is the object name of the WinCC Alarm Control. 


AXC_OnBtnScroll example 


{ 


// activate/deactivate the scroll function 
AXC_OnBtnScroll("gs_alarm_00","Controll") ; 


} 


Parameters of the AXC_OnBtnScroll function: 
"gs_alarm_00" is the name of the picture in which WinCC Alarm Control was configured. 


Control1 is the object name of the WinCC Alarm Control. 
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AXC_OnBtnSinglAckn example 


{ 
// acknowledge the active messag 
AXC_OnBtnSinglAckn ("gs_alarm_00","Controll"); 


} 


Parameters of the AXC_OnBtnSinglAckn function: 
"gs_alarm_00" is the name of the picture in which WinCC Alarm Control was configured. 


Control1 is the object name of the WinCC Alarm Control. 


AXC_SetFilter example 


{ 

BOOL ret; 

MSG FILTER STRUCT Filter; 
CMN_ERROR Error; 


//Reset the filter struct 
memset ( &Filter, 0, sizeof( MSG FILTER STRUCT ) ); 


//Set the filter nam 
strcepy( Filter.szFilterName, "Controll"); 


// Choose selection elements 
Filter.dwFilter = MSG FILTER_NR FROM | MSG FILTER _NR_TO; 


// Message number from 


Filter.dwMsgNr[0] = 2; 
// Message number to 
Filter.dwMsgNr[1l] = 2; 


ret = AXC SetFilter("gs alarm _00","Controll", &Filter, &Error) ; 
} 


1. Name the filter. 

2. Select the filter type. 

3. Specify the filter criteria. 
4. Set the filter. 
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Note 


The filter type and the filter criteria are to be adapted, all other filter types are described in the 


filter structure. 


ResetFilter example 


{ 

BOOL ret; 

MSG FILTER STRUCT Filter; 
CMN ERROR Error; 


//delete the whole Filter struct 
memset ( &Filter, 0, sizeof( MSG FILTER STRUCT ) ); 


//set an empty filter struct 
AXC_SetFilter("gs_alarm_00","Controlli",&Filter, &Error) ; 
} 


1. Delete the filter structure. 


2. Write empty values into the filter structure. 


TlgGetNumberOfColumns example 


{ 
char text[5]; 
long int columns 


//get number of Columns 
columns = GetNumberOfColumns ("TableControl 01"); 


//convert long int to char 
sprintf (text,"%sd",columns) ; 


//set text on TextField5 
SetText (lpszPictureName, "StaticText5",text) ; 
} 


Parameters of the TlgGetNumberOfColumns function: 
"TableControl_01" is the name of the WinCC Table Control. 


1. Temporarily store the return value of the TlgGetNumberofColumns in columns. 
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2. Temporarily store the return value in the text string. 


3. Output the return value to a static text field. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


TigGetNumberOfRows example 


{ 
char text[5]; 
long int rows; 


//get number of rows 
rows = TlgGetNumberOfRows ("TableControl 01"); 


//convert long int to char 
sprintf (text,"%Sd", rows) ; 


//set text on TextField5 
SetText (lpszPictureName, "StaticText5",text) ; 


} 


Parameters of the TlgGetNumberOfRows function: 


TableControl_01 is the name of the WinCC Table Control. 


1. Temporarily store the return value of the TlgGetNumberofRows in rows. 
2. Temporarily store the return value in the text string. 


3. Output the return value to a static text field. 
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TilgGetRulerTimeTrend example 


{ 

SYSTEMTIME systime; 
WORD wHour; 

WORD wMin; 

WORD wSec; 


char szTime[10]; 


//Get the current systemtime 
systime = TlgGetRulerTimeTrend("TrendControl _01",0); 


//Get the hour 


wHour = systime.wHour; 
//Get the minute 

wMin = systime.wMinute; 
//Get the second 

wSec = systime.wSecond; 
// 


sprintf (szTime,"%d:%d:%d",wHour, wMin,wSec) ; 


//output the variable name 
SetText (lpszPictureName, "StaticText7",szTime) ; 


} 


1. Read out the current system time. 
2. Read out hour, minute and second from the SYSTEMTIME structure. 
3. Create a string containing the time. 


4. Output the current time. 
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TlgGetRulerVariableNameTrend example 


{ 
char* pszVarName = NULL; 
char szVarName [20]; 


//Get the ruler variable name 
pszVarName = TlgGetRulerVariableNameTrend("TrendControl 01",0); 


if (pszVarName != NULL) 

{ 

//Copy the string 

strncpy (szVarName, pszVarName,19) ; 

} 

//output the variable name 

SetText (lpszPictureName, "StaticText6",szVarName) ; 


} 


Parameters of the TigGetRulerVariableNameTrend function: 
"TrendControl_01" is the name of the WinCC Trend Control. 


"0" is the number of the trend. 


1. Temporarily store the return value of the TlgGetRulerVariableNameTrend function in 
pszVarName. 


2. If a valid value has been returned, copy the return value to szVarName. 


3. Output the return value to a static text field. 


Note 


Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 
well. 


TigTrendWindowPressOpenDigButton example 


{ 

//Opens the Property Dialog 
TlgTrendWindowPressOpenDlgButton ("TrendControl 01"); 
} 


Parameters of the TigTrendWindowPressOpenDlgButton function: 
"TrendControl_01" is the window title of WinCC Trend Control. 
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TigTrendWindowPressStartStopButton example 


{ 
//start/stop the actualization 
TlgTrendWindowPressStartStopButton ("TrendControl 01"); 


} 


Parameters of the TigTrendWindowPressStartStopButton function: 


"TrendControl_01" is the window title of WinCC Trend Control. 


Note 
Various examples are offered for the function descriptions. For functions with a similar syntax, 
a selected function is used as a template in the example. This example must be adapted as 


well. 


TlgTrendWindowPressZoomInButton example 


{ 
//zoom in 
TlgTrendWindowPressZoomInButton("TrendControl 01"); 


} 


Parameters of the TlgTrendWindowPressZoomInButton function: 


"TrendControl_01" is the window title of WinCC Trend Control. 
TigTrendWindowPressZoomOutButton example 


{ 
// zoom out 
TlgTrendWindowPressZoomOutButton ("TrendControl 01"); 


} 


Parameters of the TigTrendWindowPressZoomOutButton function: 


"TrendControl_01" is the window title of WinCC Trend Control. 
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2.15.5 


2.15.5.1 


2.15.5.2 


Lists 


Bar direction 


Bar direction | Numeric value 


Up 0 


bottom 1 
left 2 
right 3 


Bar Scaling 


Numeric val- 


Bar Scaling 


Linear (Same weighting) 


Logarithmic (low values emphasized) 
Negative logarithmic (high values emphasized) 


Automatic (linear) 


Tangential (high and low values emphasized) 


Square (high values emphasized) 


Cubic (high values strongly emphasized) 


2.15.5.3 


1590 


Flash frequencies 


Flash frequency Assigned Value 


Slow (approx. 0.25 Hz) 0 
Medium (approx. 0.5 Hz) 1 


Fast (approx. 1 Hz) 2 


Note 


Since the flashing is performed by means of software engineering, the flash frequency is both 
system-dependent and hardware-bound (number of objects, processor speed, RAM size, 
update time etc.). 


The information in the table is therefore only for orientation purposes. 
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2.15.5.4 I/O field, output format 


The display of numeric values output into an I/O field is controlled by a format specification. 


2.15 ANSI-C function descriptions 


A format indication consists of one or several formatting characters. The valid formatting 
characters and their meaning are listed in the following table: 


Charac- | Meaning Note 
ters 
Ss Positive numbers are displayed Always in the first position of the format specification 
with signs May only appear once in the format specification 
O(ZER_ | Leading and ending zeros are out- | Always following s 
O) put. If s is missing, it is in the first position 
May only appear once in the format specification 
9 Specifies the position of a digit in May appear in the format indication as often as required. 
the number to be output 
(com- | Position of the decimal point 
ma) 
e Returns the number in exponential | Always at the last position of the format specification 
form 
Example: 
Num- | Format Representation 
ber 
123,4 | 999,999 123,455 
55 
123,4 | 999,99 123,46 
55 
123,4 | 9999,9999 | 123,4550 
55 
123,4 | s09999.99 | +0123,4550 
55 99 
123,4 |9.99999e | 1.23455e+002 
55 


If the decimal point is left out in the format specification the decimal places are not displayed 


and the 


number is rounded to an integer. 


If fewer decimal positions are provided in the format specification than the number actually 
has, only the decimal places specified in the format specification are output. 


The number is rounded correspondingly. 


If the number has more places before the decimal point than specified in the format 
specification, three asterisks (***) are output which means that the number cannot be displayed 
in this format. 
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2.15.5.5 I/O field, data type of the field content 
Data type | Numeric value 
Binary 0 
decimal 1 
string 2 
hexadeci- | 3 
mal 
2.15.5.6 I/O field, field type 
Type Numeric value 
Edition 0 
Input 1 
Output and | 2 
input 
2.15.5.7 Element alignment in check boxes and radio boxes 
Alignment | Numeric value 
2.15.5.8 Color chart 
The 16 primary colors are: 
Color Color value | symbolic constant 
(Hex) 
Red Ox000000F | CO_RED 
F 
Dark red 0x00000080 | CO_DKRED 
Green OxOO00FFO | CO_GREEN 
0 
Dark green 0x00008000 | CO_LDKGREEN 
Blue OxOOFFOOO | CO_BLUE 
0 
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Color Color value | symbolic constant 
(Hex) 
Dark blue 0x00800000 | CO_DKBLUE 
Cyan OxOOFFFFO | CO_CYAN 
0 
Dark cyan 0x00808000 | CO_DKCYAN 
Yellow OxOOOOFFF | CO_YELLOW 
F 
Dark yellow 0x00008080 | CO_L_DKYELLOW 
Magenta OxOOFFOOF | CO_LMAGENTA 
F 
Dark magenta | 0x00800080 | CO_LDKMAGENTA 
Light gray Ox00COCOC | CO_LLTGRAY 
0 
Gray 0x00808080 | CO_DKGRAY 
Black 0x00000000 | CO_BLACK 
White OxOOFFFFF | CO_WHITE 
F 
Note 


The symbolic constants are externally predefined by #define and provied by WinCC. 


2.15.5.9 Format descriptors 
For format descriptors the following type is expected: 
%d = DWORD / Int 
%f = double 
%s = char* 


It is also possible e.g. to read a text tag with %d if provisions are made that the value can be 
mapped in a DWORD. 


The following provision makes sure the value can be mapped: 


Varia- | For- | C-tag 
ble mat 


Bit %d DWORD / long int signed 
Byte %d DWORD / long int signed 
SByte | %d DWORD / long int signed 
Word | %d DWORD / long int signed 
SWor | %d DWORD / long int signed 


d 
DWor | %d DWORD / long int signed 
d 
SDWo | %d DWORD / long int signed 
rd 
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2.15.5.10 


1594 


Varia- | For- | C-tag 

ble mat 

Float | %f double 

Dou- VF double 

ble 

Char |%s char* 
Note 


If a"DWORD," for which the 32nd bit is set, is to be read, a format descriptor must be used 
for unsigned integers (Yu). 


Fill pattern 
Fill pattern Value 
Transparent 65536 
Solid 0 
Fill pattern Value Fill pattern Value Fill pattern Value 
| 1048576 196611 196627 
a 1048577 196612 196628 
i 1048578 196613 196629 
~~. 1048579 196614 196630 
Ei 1048832 196615 196631 
-— 1048833 196616 196632 
1048834 196617 ees 196633 
ari 
1048835 196618 QORQQRQQ 196634 
es se 
— 131072 196619 HA 196635 
HITT 131073 196620 = 196636 
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Fill pattern Value Fill pattern Value Fill pattern Value 
N : 131074 196621 196637 
Gf, 131075 196622 196638 
Ld 
131076 196623 196639 
196608 196624 196640 
196609 196625 196641 
196610 196626 196642 


Note 


The "Solid" fill pattern fills the object with the set background color. 


2.15.5.11 Line styles 


Line style 


symbolic name 
LS SOLID 


—_—_—— LS_DASH 


LS_DOT 


_ LS_DASHDOT 


hidden 


LS_DASHDOT- 
DOT 


LS_INVISIBLE 


2.15.5.12 Line end style 


Line end | symbolic name Value for the left line ends Value for the right line ends 
= LE_NO 0 0 

= LE_HOLLOW_ARROW | 1 65536 

> LE_FULL_ARROW 2 131072 
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Line end 


symbolic name 


Value for the left line ends 


Value for the right line ends 


—< LE_CFULL_ARROW 3 196608 
| LE_LINE 4 262144 
5 LE _HOLLOW_CIRCLE | 5 327680 
—e LE_FULL_CIRCLE 6 393216 
Note 


From a line width > 5 the line end "empty circle" is displayed as filled circle. 


2.15.5.13 List types 
List type Numeric value 
decimal 0 
Binary 1 
bit 2 
2.15.5.14 Language ID 


WinCC only supports the SUBLANG_DEFAULT languages of Windows. 


symbolic name Value (hexadeci- | Abbreviation 

mal) 
LANG_ARABIC 0x0401 
LANG_AFRIKAANS 0x0436 
LANG_ALBANIAN 0x041C 
LANG_BASQUE 0x042D 
LANG_BULGARIAN 0x0402 
LANG_BYELORUSSIAN 0x0423 
LANG_CATALAN 0x0403 
LANG_CHINESE 0x0404 
LANG_CROATIAN 0x041A 
LANG_CZECH 0x0405 CSY 
LANG_DANISH 0x0406 DAN 
LANG_DUTCH 0x0413 NLD 
LANG_ENGLISH 0x0409 ENU 
LANG_ESTONIAN 0x0425 
LANG_FAEROESE 0x0438 
LANG_FARSI 0x0429 
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symbolic name Value (hexadeci- | Abbreviation 
mal) 

LANG_FINNISH 0x040B FIN 

LANG_FRENCH 0x040C FRA 

LANG_GERMAN 0x0407 DEU 

LANG_GREEK 0x0408 

LANG_HEBREW 0x040D 

LANG_HUNGARIAN 0x040E HUN 

LANG_ICELANDIC 0x040F ISL 

LANG_INDONESIAN 0x0421 

LANG_ITALIAN 0x0410 ITA 

LANG_JAPANESE 0x0411 

LANG_KOREAN 0x0412 

LANG_LATVIAN 0x0426 

LANG_LITHUANIAN 0x0427 

LANG_NORWEGIAN 0x0414 NOR 

LANG_POLISH 0x0415 PLK 

LANG_PORTUGUESE 0x0416 PTB 

LANG_ROMANIAN 0x0418 

LANG_RUSSIAN 0x0419 RUS 

LANG_SLOVAK 0x041B SKY 

LANG_SLOVENIAN 0x0424 

LANG_SORBIAN 0x042E 

LANG_SPANISH 0x040A ESP 

LANG_SWEDISH 0x041D SVE 

LANG_THAI 0x041E 

LANG_TURKISH 0x041F TRK 

LANG_UKRAINIAN 0x0422 


2.15.5.15 Text alignment 


Hori- Align- Numeric value 
zontal ment 

left 0 

centered | 1 

right 2 
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Verti- | Align- Numeric value 
cal ment 

Up 0 

centered 

bottom 2 


2.15.5.16 Tag statuses 


Value (dec- | Value (hex- Meaning 

imal) decimal) 

0 0x0000 No error 

1 0x0001 Connection to partner not established 
2 0x0002 Handshake error 

4 0x0004 Network module defective 

8 0x0008 Configured upper limit exceeded 

16 0x0010 Configured lower limit exceeded 

32 0x0020 Format upper limit exceeded 

64 0x0040 Format lower limit exceeded 

128 0x0080 Conversion error 

256 0x0100 Tag initialization value 

512 0x0200 Tag replacement value 

1024 0x0400 Channel addressing error 

2048 0x0800 Tag not found or not available 

4096 0x1000 Access to tag not permitted 

8192 0x2000 Timeout, no check-back message from the channel 
16384 0x4000 Server not available. 
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2.15.6 Structure definitions 


2.15.6.1 Structure definition CCAPErrorExecute 


typedef struct { 
DWORD dwCurrentThreadID; Thread ID of the current thread 


DWORD dwErrorCodel; Error code 1 

DWORD dwErrorCode2; Error code 2 

BOOL bCycle; cycle/acycle 

char* szApplicationName; Name of the application 
char* szFunctionName; ame of the function 

char* szTagName; ame of the tag 

LPVOID lpParam; Pointer to the action stack 
DWORD dwParamSize; Size of the action stack 
DWORD dwCycle; Cycle of the variable 

CMN ERROR* pError; Pointer to CMN_ ERROR 


} CCAPErrorExecute; 


Members 
The meaning of the individual error IDs and the structure elements depending on them are 
specified in the following table: 
> |3 |¢ |e |2 /2 |8 |8 | [Is |&§ 
S 3 g © a w > = s 
o re) >_> oS o AT 5 
oO oO oO z ra = £ £ Z 7 — 
= = 2 c Cc ro) oS = 
3 rs) ce) 2 © a oo ad a 
7 = es |o |N Ja © 
y ¥ 3) c “a a t oO 
= =| 
cS xo) a. LL v 
Qa N 
zt “ 
w“ 
1007001 |0 X X xX X X Action requires exception 
1007001 | 1 X X X X X Exception when access- 
ing the return result 
1007001 | 4097 x X X X x Stack overflow while exe- 
cuting the action 
1007001 | 4098 xX X X X xX The action contains a di- 
vision by 0 
1007001 | 4099 X X X X X The action contains an ac- 
cess to a non-existing 
symbol 
1007001 | 4100 X X X X X The action contains an ac- 
cess violation 
1007004 |0 x X X Function is not known 
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1007005 | 1 xX xX Action does not include a 
P code. 

1007005 |2 Xx xX Incorrect function name 

1007005 |4 X X X X X Return value type is inva- 
lid 

1007005 | 32768ff | X X X X X Ciss Compiler error when 
loading the action 

1007006 |0 xX Xx Xx Xx Xx Xx Xx Tag is not defined 

1007006 X X X X X X X Tag timeout 

1007006 | 2 X X X X X X X Tag cannot be returned in 
the desired format 

1007006 | 3 X X X X X X X Tag returns status viola- 
tion, status present in 
CMN_ERROR.dwError1 

1007007 | 1 X X X X X Error in PDLRTGetProp 

1007007 | 2 X X X X X Error in PDLRTSetProp 

1007007 |3 X X X X X Error with DM call 

Error structure 


The OnErrorExecute function uses the error structure to evaluate or to output error messages, 
if marked by an "x" in the pError column. 


See also 


Structure definition CMN_ERROR (Page 1601) 


2.15.6.2 


typedef struct { 
DWORD dwCurrentThreadID; 


ThreadID of th 


Structure definition CCAPTime 


DWORD dwCode; Code 

BOOL bCycle; cycle/acycle 

char* szApplicationName; Name of the Application 
char* szFunctionName; Name of the Function 

LPVOID lpParam; Pointer to the Action-Stack 
DWORD dwParamSize; size of the Action-Stack 
double dblTime; 

DWORD dwFlags; flags 

} CCAPTime; 

1600 


current Thread 
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Members 


dwCode 
The structure element dwCode provides information on calling OnTime: 


dwCode = 113 Call with time definition for each action 


dwCode = 114 Call with time monitoring for each action 


dwFlags 
The structure element dwFlags provides information on the output type: 


dwFlags = TRUE __| The results are output to a file 


dwFlags = FALSE | The results are output to the diagnostics window 


2.15.6.3 Structure definition CMN_ERROR 


struct CMNERRORSTRUCT { 

DWORD dwErrorl, 

DWORD dwError2, 

DWORD dwError3, 

DWORD dwError4, 

DWORD dwError5; 

TCHAR szErrorText [MAX ERROR LEN]; 

} 

CMN_ERROR 

Description 
The extended error structure contains the error code and an error text for the error that has 
occurred. Each application can use the error structure to evaluate or to output error messages. 

Members 


dwError1 .. dwError5 
These entries can be used in any way by the API functions. 


The API descriptions inform about the values the respective entries contain in case of an error. 
If not specified otherwise, the error codes are present in dwError 1. 
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szErrorText 


Buffer for the text description of the error cause 


The content is determined from the resources and therefore language-dependent. 


2.15.6.4 


typedef struct { 

DWORD dwType; 

DWORD dwSize; 

char szTypeName [MAX DM TYPE 
} 

DM_TYPEREF; 


NAME + 


Members 


dwType 
Specifies the tag type 


DM_VARTYPE_BIT 


Structure definition DM_TYPEREF 


Binary tag 


DM_VARTYPE_SBYTE 


Signed 8-bit value 


DM_VARTYPE_BYTE 


Unsigned 8-bit value 


DM_VARTYPE_SWORD 


Signed 16-bit value 


DM_VARTYPE_WORD 


Unsigned 16-bit value 


DM_VARTYPE_SDWORD 


Signed 32-bit value 


DM_VARTYPE_DWORD 


Unsigned 32-bit value 


DM_VARTYPE_FLOAT 


Floating-point number 32-bit IEEE 754 


DM_VARTYPE_DOUBLE 


Floating-point number 64-bit IEEE 754 


DM_VARTYPE_TEXT_8 


Text tag, 8-bit font 


DM_VARTYPE_TEXT_16 
DM_VARTYPE_RAW 


Text tag, 16-bit font 
Raw data type 


DM_VARTYPE_STRUCT 


Structure tag 


DM_VARTYPE_TEXTREF 


Text reference tag 


dwSize 


Specifies the length of the data type in bytes. 


szTypeName 


In the case of structure tags, contains the name of the structure type 


1602 
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2.15.6.5 Structure definition DM_VAR_UPDATE_STRUCT 


typedef struct { 

DM _TYPEREF dmTypeRef; 
DM _VARKEY dmVarKey; 
VARIANT dmValue; 


DWORD dwState; 
} 


DM _VAR_UPDATE STRUCT; 


Members 


See also 


dmTypeRef 

Contains information on the tag type. For performance reasons, nothing is entered into this 
structure in case of cyclic requirements. 

dmVarKey 

Specifies the tags to be edited. 


dmValue 
Tag value 


Upon access to the value of the VARIANT a ".u." has to be inserted between the name of the 
VARIANT and the name of the member. 


Example: 

// Supply variant 
myVariant.vt = VT_ 14; 
myVariant.u.1lVal = 233; 


A description of the data type VARIANT can be found in the associated documentation. The 
VARIANT dmValue must be initialized with Variantlnit() before first use and enabled again with 
VariantClear(&dmValue) after use. For this reason, the structure 
DM_VAR_UPDATE_STRUCT must not be deleted with ZeroMemory() or memset(). 

dwState 


Identifies the tag status. 


Tag statuses (Page 1598) 
Structure definition DM_VARKEY (Page 1605) 
Structure definition DM_TYPEREF (Page 1602) 
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2.15.6.6 Structure definition DM_VAR_UPDATE_STRUCTEX 


typedef struct { 

DM _TYPEREF dmTypeRef; 
DM_VARKEY dmVarKkey; 
VARIANT dmValue; 

DWORD dwState; 

DWORD dwQualityCode; 

} 

DM_VAR_UPDATE STRUCTEX; 


Members 


dmTypeRef 

Contains information on the tag type. For performance reasons, nothing is entered into this 
structure in case of cyclic requirements. 

dmVarKey 

Specifies the tags to be edited. 


dmValue 
Tag value 


Upon access to the value of the VARIANT a ".u." has to be inserted between the name of the 
VARIANT and the name of the member. 


Example: 

// Supply variant 
myVariant.vt = VT 14; 
myVariant.u.lVal = 233; 


A description of the data type VARIANT can be found in the associated documentation. The 
VARIANT dmValue must be initialized with Variantlnit() before first use and enabled again with 
VariantClear(&dmValue) after use. For this reason, the structure 
DM_VAR_UPDATE_STRUCTEX must not be deleted with ZeroMemory() or memset(). 
dwState 


Identifies the tag status. 


dwQualityCode 
Identifies the tag quality code. 
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See also 
Tag statuses (Page 1598) 
Structure definition DM_VARKEY (Page 1605) 
Structure definition DM_TYPEREF (Page 1602) 


2.15.6.7 Structure definition DM_VARKEY 


typedef struct { 

DWORD dwKeyType; 

DWORD dwID; 

char szName[ MAX DM VAR NAME + 1 ]; 
LPVOID lpvUserData; 

} 
DM_VARKEY; 


Members 


dwKeyType 

Defines whether the tag is to be addressed by a key ID or by its name. 
DM_VARKEY_ID Specification via key ID 

DM_VARKEY_NAME Specification via tag name 


dwlD 
Contains the key ID of the tags if dwKeyType is set accordingly 


szName 


Contains the name of the tag if dwKeyType is set accordingly 


IpvUserData 
Pointer to application-specific data 


2.15.6.8 Structure definition LINKINFO 


typedef struct { 
,INKTYPE LinkType; 
DWORD dwCycle; 

TCHAR szLinkName [256]; 
} 
LINKINFO; 
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Members 


LinkType 


LinkType are enumeration constants defined in the "Trigger.h" file. They are to be integrated 
into your script with the #include "Trigger.h" command and the corresponding enumeration 


constants. 
BUBRT_LT_NOLINK no shortcut 
BUBRT_LT_VARIABLE_DIRECT direct tag 
BUBRT_LT_VARIABLE_INDIRECT indirect tag 
BUBRT_LT_ACTION C action 


BUBRT_LT_ACTION_WIZARD 


Dynamic Dialog 


BUB_LT_DIRECT_CONNECTION 


Direct connection 


BUBRT_LT_ACTION_WIZARD_INPROC 


O;a;yRI/w)hyo|)-A]o 


Dynamic Dialog 


For the function SetLink only the enumeration constants BUBRT_LT_VARIABLE_DIRECT and 
BUBRT_LT_VARIABLE_INDIRECT may be used. The function GetLink allows to return all 


listed enumeration constants. 


dwCycle 
Update cycle time 
dwCycle Update Cycle 
255 Picture cycle 
235 Window Cycle 
0 Upon change 
1 250ms 
2 500 ms 
3 1s 
4 2s 
5 5s 
6 10s 
7 dmin 
8 5min 
9 10min 
10 th 
11-15 User cycle 1-5 
szLinkName 
Tag name 
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2.15.6.9 Structure definition MSG_FILTER_STRUCT 


typedef struct { 


CHAR szFilterName [MSG MAX TEXTLEN+1]; 
WORD dwFilter; 
SYSTEMTIME st[2]; 
DWORD dwMsgNr[2]; 
DWORD dwMsgClass; 
DWORD dwMsgType [MSG MAX CLASS]; 
DWORD dwMsgState; 
WORD wAGNr [2]; 
WORD wAGSubNr [2]; 
DWORD dwArchivMode; 
char szTB[MSG MAX TB] [ 
SG_ MAX _TB_CONTENT+1 
DWORD dwTB; 
Double dPValue [MSG MAX PVALUE] [2]; 
DWORD dwPValue[2]; 
DWORD dwMsgCounter [2]; 
DWORD dwQuickSelect; 
} 
SG_FILTER_STRUCT; 


Description 


In this structure the filter criteria are specified. 


Members 


dwFilter 


The filter conditions are defined by means of the following constants from the file "m_global.h": 


MSG_FILTER_DATE_FROM Date from 
MSG_FILTER_DATE_TO Date to 
MSG_FILTER_TIME_FROM Time from 
MSG_FILTER_TIME_TO Time to 


MSG_FILTER_NR_FROM 


Message number from 


MSG_FILTER_NR_TO 


Message number to 


MSG_FILTER_CLASS 


Message classes 


MSG_FILTER_STATE 


Message status 


MSG_FILTER_AG_FROM 


AS number from 


MSG_FILTER_AG_TO 


AS number to 


MSG_FILTER_AGSUB_FROM 
MSG_FILTER_AGSUB_TO 


AG subnumber from 
AG subnumber to 


MSG_FILTER_TEXT 


Message texts 


MSG_FILTER_PVALUE 


Process values 
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MSG_FILTER_COUNTER_FROM 


Internal message counter from 


MSG_FILTER_COUNTER_TO 


Internal message counter to 


MSG_FILTER_PROCESSMSG 


Process messages 


MSG_FILTER_SYSMSG 


System messages 


MSG_FILTER_BEDMSG 


Operator messages 


MSG_FILTER_DATE 


Date from to 


MSG_FILTER_TIME 


Time from to 


MSG_FILTER_NR 


Message number from to 


MSG_FILTER_VISIBLEONLY 


Display visible messages 


MSG_FILTER_HIDDENONLY 


Display hidden messages 
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st 
Date/time from - to 
Where st[0] is the start time (from), st[1] the end time (to) 


Assign these fields for the filter criteria: MSG_FILTER_DATE, MSG_FILTER_DATE_FROM, 
MSG_FILTER_DATE_TO, MSG_FILTER_TIME, MSG_FILTER_TIME_FROM or 
MSG_FILTER_TIME_TO 


If a current time is needed for the transfer of a SYSTEMTIME parameter the function 
GetLocalTime is to be used instead of GetSystemTime. As a rule there is a significant time 
difference between these two functions. 


dwMsgNr 

Message number from - to 

Where dwMsgNr(0] is the start no. (from), dwMsgNr[1] the end no. (to) 

Assign these fields for the filter criteria: MSG_FILTER_NR, MSG_FILTER_NR_FROM or 
MSG_FILTER_NR_TO 

dwMsgClass 

Message classes bit-coded. 

Assign this field for the filter criterion: MSG_FILTER_CLASS 


dwMsgType 
Message type per message class, bit-coded 
Assign this field for the filter criterion: MSG_FILTER_CLASS 


dwMsg State 
Message status bit-coded. 
Assign this field for the filter criterion: MSG_FILTER_STATE 


WAGNr 
AGNr from - to 
Assign these fields for the filter criteria: MSG_FILTER_AG_FROM or MSG_FILTER_AG_TO 
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wAGSubNr 

AGSubMr from - to 

Assign this field for the filter criteria: MSG_FILTER_AGSUB_FROM or 
MSG_FILTER_AGSUB_TO 

dwArchivMode 

Archiving / logging 

Must be assigned 0. 


szTB 
Texts of the text blocks 
Assign these fields for the filter criterion: MSG_FILTER_TEXT 


dwTB 
Active text blocks (from - to, bit-coded) 
Assign this field for the filter criterion: MSG_FILTER_TEXT 


dPValue 
Process values from - to 
Assign these fields for the filter criterion: MSG_FILTER_PVALUE 


dwPValue 
Active process values (from - to, bit-coded) 
Assign this field for the filter criterion: MSG_FILTER_PVALUE 


dwMsgCounter 

Internal message counter from - to 

Assign these fields for the filter criteria: MSG_FILTER_COUNTER_FROM, 
MSG_FILTER_COUNTER_TO 

dwQuickSelect 

Quick selection for hour, day, month 

The parameter is reserved for future upgrades and must be preset to 0. 
Assign this field for the filter criterion: MSG_FILTER_QUICKSELECT 


LOWORD type: 

MSG_FILTER_QUICK_MONTH Quick selection last n months 
MSG_FILTER_QUICK_DAYS Quick selection last n days 
MSG_FILTER_QUICK_HOUR Quick selection last n hours 


HIWORD number: 1...n 


The end time of the quick selection refers to the current system time of the local computer. 
The start time is calucalted back n * ( months, days, hours ). 
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2.15.6.10 


typedef struct { 


DWORD dwMsgState; 

DWORD dwMsgNr; 

SYSTEMTIME stMsgTime; 

DWORD dwTimeDiff; 

DWORD dwCounter; 

DWORD dwFlags; 

WORD wPValueUsed; 

WORD wTextValueUsed; 

double dPValue [MSG MAX PVALUE]; 


MSG _TEXTVAL STRUCT 


} 
MSG _RTDATA_ STRUCT; 


Structure definition MSG_RTDATA_STRUCT 


mtTextValue [MSG MAX PVALUE]; 


Members 

dwMsg State 

Message status 
MSG_STATE_COME 0x00000001 Message came in 
MSG_STATE_GO 0x00000002 Message went out 
MSG_STATE_QUIT 0x00000003 Message acknowledged 
MSG_STATE_LOCK 0x00000004 Message locked 
MSG_STATE_UNLOCK 0x00000005 Message unlocked 
MSG_STATE_QUIT_SYSTEM 0x00000010 Message acknowledged by system 
MSG_STATE_QUIT_EMERGENCY 0x0000001 1 Emergency acknowledgement 
MSG_STATE_QUIT_HORN 0x00000012 Horn acknowledgement 
MSG_STATE_COMEGO 0x00000013 Message came in and went out, only display in message list 
MSG_STATE_UPDATE 0x00010000 Bit for message update 
MSG_STATE_RESET 0x00020000 Bit for message reset 
MSG_STATE_SUMTIME 0x00040000 Bit active for daylight savings time 
MSG_STATE_INSTANCE 0x00080000 Bit for instance message (n messages of a no.) 


dwMsgNr 
Message number 


stMsgTime 


Date/Time: Telegram time depending on the calling function 


dwTimeDiff 


Duration coming/Telegram time in seconds 
dwCounter 


Internal message counter 
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dwFlags 


Message flags in the database 


MSG_FLAG_SUMTIME 0x00000001 Daylight savings time active 
MSG_FLAG_COMMENT 0x00000002 Message has comments 
MSG_FLAG_ARCHIV 0x00000004 Archiving 

MSG_FLAG_PROTOCOL 0x00000008 Logging 

MSG_FLAG_TEXTVALUES 0x00000010 Message has values accompanying the text 
MSG_FLAG_TIMEINVALID 0x00000020 Bit for invalid date/time stamp 
MSG_FLAG_INSTANCE 0x00000040 Instance message identification (185269) 


wPValueUsed 


Process values used, bit-coded. Every bit may only be set in one of the two structure elements 
"wPValueUsed" or "wTextValueUsed". An accompanying value may either be a number or a 
text. 


wTextValueUsed 


text values used, bit-coded. Every bit may only be set in one of the two structure elements 
"wPValueUsed" or "wTextValueUsed". An accompanying value may either be a number or a 
text. 
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3.1 Automated configuration 


Contents 
You can use VBA to automate configuration in Graphics Designer. This comprises: 
e Adaptation of the Graphics Designer 
e Editing of pictures 
e Editing of objects 
e Dynamizing with VBA 
e Access to external applications 
A VBA editor is available for this purpose in the "Graphics Designer" editor. 
This chapter contains 
@ a brief introduction on how to use VBA in WinCC, 
e basic information on using VBA in Graphics Designer and 


e reference to the VBA object model in Graphics Designer. 
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3.2 Introduction: Using VBA in WinCC 
3.2.1 Introduction: Using VBA in WinCC 
Introduction 


You have a VBA editor available in Graphics Designer which allows you to configure pictures 
automatically. The VBA editor is identical to the one from the products in the Microsoft Office 
family. You can make direct use of your VBA programming experience. 


Principle 


With VBA you extend the functionality of the Graphics Designer and automate configuring. 
You may use VBA in Graphics Designer as follows, including: 


@ Creating user-defined menus and toolbars 

@ Creating and editing Standard, Smart and Windows objects 

e Adding dynamics to properties of pictures and objects 

@ Configuring actions in pictures and objects 

e Accessing products that support VBA (e.g. products in the MS Office family) 


A description of the VBA object model for the Graphics Designer is provided in this 
documentation in the section under "VBA Reference". 


See also 
Organizing VBA Code in a WinCC Project (Page 1615) 
VBA Reference (Page 1745) 
VBA in the Graphics Designer (Page 1621) 
Executing VBA Macros in Graphics Designer (Page 1619) 
Differentiation: Using VBA (Page 1614) 


3.2.2 Differentiation: Using VBA 


Introduction 


You can use VBA exclusively for configuration and functional enhancement in the Graphics 
Designer. The following indicates where there are better options available for efficient 
configuration or where VBA cannot be used. 
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VB and C Scripts 


VB and C scripts are active only at runtime and are used to dynamize picture and object 
properties as well as in action configuration. 


Dynamic Wizards 


The dynamic wizards are not replaced by VBA. However, VBA allows you to enhance the 
functionality of the dynamic wizards with ease. 


ODK 


ODK comprises function calls that enable access to all the functionality of WinCC both in the 
configuration system and in runtime. In contrast to ODK, VBA offers simple object-oriented 
access to the objects of the Graphics Designer. 


See also 
VBA in the Graphics Designer (Page 1621) 
Executing VBA Macros in Graphics Designer (Page 1619) 
Organizing VBA Code in a WinCC Project (Page 1615) 
Introduction: Using VBA in WinCC (Page 1614) 


3.2.3 Organizing VBA Code in a WinCC Project 


Introduction 


You organize the VBA code for your WinCC project in the VBA editor. This is where you specify 
whether the VBA code is to be available in only one picture, in the entire project or in all projects. 
Depending on where you place the VBA code, the term used to refer to the code is: 


@ global VBA code, 
@ project-specific VBA code or 


@ picture-specific VBA code. 


Note 


A picture in the Graphics Designer is known as a "document" in the VBA object model. 


The VBA editor 


To start the VBA editor in the Graphics Designer, press <ALT+F 11> or choose "Tools" > 
"Macros" > "Visual Basic Editor". If you have not yet opened a picture in the Graphics Designer, 
you can only edit the global or project-specific VBA code. 


The global and project-specific data and all open pictures are displayed in the VBA editor's 
Project Explorer: 
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i Ee 
ly fo @) | in 24, Col 1 = 
Project -ProjectTemplate [J os = 
(General) | |CreateApplicationMenus ¥ 
les) |=Sh IE - 
= Sub InsertMenulItems () a 


=) 8% GlobalTemplate (C:\Pro 
=) 4 Graphics Designer Obje 


'VBA4 


@-——_] ThisDocument (Bild¢ 


GlobalTemplateDoc) 
‘=| 8% ProjectTemplate (C:\\Ph\ 
(=) Graphics Designer Obje 
ProjectTemplateDoy 
(9 References 
(=) 8% ¥BAProject3 
(=) 9 Graphics Designer Obje 


Dim obj] Menul As HMIMenu 
Dim obj Menu2 As HMIMenu 
Dim obj MenuIteml is HMIMenulItem 
Dim objSubMenul is HMIMenulItem 


‘Create Menu: 
Set objMenul = Application.CustomMenus.InsertMenu(1, "a 
(=) 9 References 


&8 Reference to @PRY 'Next lines add menu-items to userdefined menu. 


ral 7 | oa ‘Parameters are "Position", "Key" and DefaultLabel: 
= ‘eel ey = 
Properties - ProjectTemplateey Set objMenuItem1 = objMenul.MenulItems.InsertMenulItem(1, 
ProjectTempl. Document v Set objMenulIteml = objMenul.MenulItems.InsertMenultem(2, 
Alphabetic | Categorized ‘Adds seperator to menu ("Position", "Key') 
Common¥BSCoc iA) Set objMenulIteml = objMenul.MenulItems.InsertSeparator (3 
Common¥BSEve | 
Common¥BSPro} ‘Adds a submenu into a userdefined menu 
Hide True — Set objSubMenul = objMenul.Menultems.InsertSubMenu(4, " 
LayerDeclutterir False | 
ObjectSizeDeclu False = | '‘Rdds a menu-item into a submenu 

aa 
TABOrderAllHMI False Set objMenultem1 = objSubMenul.SubMenu. InsertMenulItem(5Sy) 
TABOrderKeybo True | = <)\ | i 


Global VBA code (1) 


Refers to VBA code that you write to the "GlobalTemplateDocument" in the VBA editor. This 
VBA code is saved in the "@GLOBAL.PDT" file, which is located in the WinCC installation 
directory. 


The VBA code that you put in the "GlobalTemplateDocument" is the code that you want to be 
made available in all WinCC projects on your computer. If you need the VBA code on a different 
computer, use the export and import functions in the VBA editor. 


A WinCC computer uses only the @GLOBAL.PDT stored locally in the WinCC installation 
directory (...\Siemens\WinCC\Templates). 


Note 


When you perform an update installation, your global "@Global.pdt" template is saved in the 
"@Global.sav" backup file. The backup file is saved in the ...\Siemens\WinCC\Templates 
directory. Your VBA code from the old global template is not automatically applied to the new 
global template. 


Applying the VBA Code from the Old Global Template: 
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In order to apply the VBA code from the old template after an update installation, proceed as 
follows: 


1. If you have already entered VBA code into the new global template, open the VBA editor 
in the Graphics Designer and copy the VBA code. 


. Close WinCC. 

. Open the ...\Siemens\WinCC\Templates directory in Windows Explorer. 
. Delete the new global template "@Global.pdt". 

. Rename the "@Global.sav" backup file to "@Global.pdt". 


. If you have already copied VBA code from the new global template, open the VBA editor 
in the Graphics Designer and insert the copied VBA code. 


Oo a Ff W ND 


The VBA code from your old global template is available again. 


Project-specific VBA code (2) 


Refers to VBA code that you write to the "ProjecttemplateDocument" in the VBA editor. This 
VBA code is saved in the @"PROJECT.PDT" file, which is located in the root directory of each 
WinCC project. 


The "@PROJECT.PDT" file has a reference to the "@GLOBAL.PDT" file. Functions and 
procedures which you have saved in the "@GLOBAL.PDT" file can be called up directly in the 
"Projectl emplateDocument". 


The "ProjectTemplateDocument" is where you put VBA code that you want to use in all pictures 
in the open project. If you need the VBA code on a different computer, use the export and 
import functions in the VBA editor. 


You can open and edit the "@PROJECT.PDT" file in the same way as a PDL file. This will 
allow you to use the "®@PROJECT.PDT" file as a template: For example, you may create there 
the basic picture of your system which will then be automatically transferred into each new 
PDL file of the project. Picture properties such as layers or zoom are not copied to the PDL 
file, nor is the VBA code. 


Picture-specific VBA code (3) 


Refers to VBA code that you write to the document "This Document" relating to the 
corresponding picture in the VBA editor. This VBA code is saved as a PDL file together with 
the picture. 


The PDL file has a reference to the "@PROJECT.PDT" file. Functions and procedures which 
you have saved in the "@PROJECT.PDT" file can be called up directly from the PDL file. 
However, you do not have access to functions or procedures that are stored in the 
"@GLOBAL.PDT" file. 


Note 
You can create modules, class modules and user forms in each document. 


You can protect the VBA code of a module against unauthorized access by setting a password. 
To do this, select the "Tools" > "VBAObject Properties" menu item in the VBA editor. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 1617 


VBA for Automated Configuration 


3.2 Introduction: Using VBA in WinCC 


Special features during the execution of VBA macros 


For the execution of VBA macros, the following applies: Initially picture-specific VBA code is 
executed, followed by project-specific VBA code. If therefore you call a VBA macro that is 
contained for example both in the picture and in the project-specific VBA code, only the VBA 
macro from the picture is executed. This has the effect of preventing VBA macros and functions 
from being executed twice, which otherwise can lead to errors. 


In connection with event handling the forwarding of events is activated by default. You can 
prevent events from being forwarded if you want to respond to an event in the picture-specific 
VBA code only. 


Additional information on this topic is given under "Event Handling". 


Testing with the Debugger 


See also 


3.2.4 


Principle 


Procedure 
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You can test your VB scripts at runtime with the VBA editor's debugger. You may find additional 
information in the help system of the VBA editor. 


Event Handling (Page 1709) 

VBA in the Graphics Designer (Page 1621) 

Executing VBA Macros in Graphics Designer (Page 1619) 
How to export and import VBA code (Page 1618) 


How to export and import VBA code 


In the VBA editor you can import and export VBA code, enabling you to transfer it to another 
computer. References to procedures and functions which you call within the project are 
therefore retained. 


Note 


When you import VBA code you must enter references to external libraries manually after the 
import process, on the target computer. 


Exporting VBA code 
1. Inthe VBA editor's Project Explorer, select the module, whose VBA code you want to export. 


2. Choose the "File" > "Export File menu commana". 
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3. Select the path and enter the file name. 

4. Click "Save". 

The VBA code is exported to a file. The file type depends on the module from which the VBA 
code was exported. 

Importing VBA code 


1. Inthe VBA editor's Project Explorer, select the document into which you want to import the 
VBA code. 


2. Choose the menu option "File" > "Import File". 


3. Select the file and click "Open" in order to import the VBA code as "ThisDocument" into the 
"Class Modules" folder. 


4. Inthe "Class Modules" folder, open the document "ThisDocument" and copy the VBA code 
into the document in the required project. 


See also 

Organizing VBA Code in a WinCC Project (Page 1615) 
3.2.5 Executing VBA Macros in Graphics Designer 
Introduction 


Three possibilities are available to you for executing VBA macros in the Graphics Designer: 
e Event Handling 

e User-defined menu or toolbar 

e VBA editor 


Event Handling 


Predefined events (such as the opening of a picture) can occur in the Graphics Designer, the 
active picture or the component library, to which you can respond with VBA event handlers. 
These events occur only during configuring in the Graphics Designer and have nothing to do 
with the events of action configuring. 


In this example, a brief message is to be issued when a picture is opened. The "Opened event" 
is used for this: 


Private Sub Document _Opened(CancelForwarding As Boolean) 
sgBox ("Picture was opened!") 
End Sub 


Further information on the subject of event handling is provided under "Event handling" and 
"Events". 
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User-defined menu or toolbar 


VBA editor 


See also 
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VBA allows you to create user-defined menus and toolbars in the Graphics Designer. You can 
assign a VBA macro to each user-defined menu entry or icon; this macro is then executed 
when you click on the menu entry or the icon. This way you can extend the functionality of the 
Graphics Designer to suit your requirements. 


Further information on the creation of user-defined menus and toolbars is provided under 
"Creating your own menus and toolbars". 


You can start a VBA macro in the VBA editor by pressing <F5>. If you press <F8>, you can 
execute a VBA macro step by step. 


VBA Reference (Page 1745) 

Event Handling (Page 1709) 

Creating Customized Menus and Toolbars (Page 1627) 
VBA in the Graphics Designer (Page 1621) 

Organizing VBA Code in a WinCC Project (Page 1615) 
Introduction: Using VBA in WinCC (Page 1614) 
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3.3 VBA in the Graphics Designer 
3.3.1 VBA in the Graphics Designer 
Introduction 


You use VBA in the Graphics Designer in order to automate frequently recurring steps during 
configuring. You can create user-defined menus and toolbars in order to make it easier to 
execute the VBA macros that you have created. 


Basically, in the Graphics Designer you can replace all configuring work that you would 
otherwise perform with the mouse with VBA macros. This applies in particular to the GUI (layers 
and zoom) and the editing of objects in pictures including dynamics. 


Adapting the Graphics Designer with VBA 


The Graphics Designer is represented by the Application object in VBA. With VBA you can 
carry out configuring in the Graphics Designer in several languages, create user-defined 
menus and toolbars and access the component library. 


Editing Pictures with VBA 
A picture in the Graphics Designer is represented by the Document object. 


With VBA you can access the properties of the picture and edit settings for layers and the 
zoom factors. As well as this you can create picture-specific menus and toolbars. These are 
only visible, however, for as long as the picture is active. 


Editing Objects with VBA 


An object in the picture is represented by the HMlObject object. With VBA you can create and 
delete objects and access the object properties. For example, with VBA you can very quickly 
create a large number of objects with identical properties for your plant display. 


Creating Dynamics with VBA 


VBA enables you to add dynamics to properties and events of pictures and objects. 


Event Handling 


With VBA you can respond to events that occur in the Graphics Designer or in a picture, for 
example when you insert a new object into a picture. You use event handling in order to execute 
VBA macros in certain program situations. 
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Access to external applications 


See also 


1622 


You can use VBA to access programs which support VBA, for example products in the 
Microsoft Office family. This means that you have an opportunity to read values from an Excel 
table and then assign them to object properties. 


Note 
Access to applications that were compiled with .net 


You need to recompile applications that were compiled with .net to enable access to VBA in 
Graphics Designer. 


Editing Pictures with VBA (Page 1654) 

SymbolLibrary Object (Page 2074) 

HMIObject Object (Page 1988) 

Document Object (Page 1949) 

Application Object (Page 1909) 

Accessing External Applications with VBA (Page 1713) 
Event Handling (Page 1709) 

Creating Dynamics with VBA (Page 1686) 

Editing Objects with VBA (Page 1660) 

Adapting the Graphics Designer with VBA (Page 1623) 
Introduction: Using VBA in WinCC (Page 1614) 
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3.3.2 Adapting the Graphics Designer with VBA 
3.3.2.1 Adapting the Graphics Designer with VBA 
Introduction 


In VBA the Application object represents the Graphics Designer: 


Access to the component library 


VBA gives you full access to the component library. You can extend the component library 
with VBA by for example creating and deleting folders or copying objects and inserting them 
into a picture. 


User-defined menus and toolbars 


You can create user-defined menus and toolbars in order to execute VBA macros in the 
Graphics Designer. In this way you can extend the functionality of the Graphics Designer to 
suit your particular requirements. 


Language-dependent configuring 


With VBA you can carry out configuring in the Graphics Designer in more than one language. 
You therefore have access to the language-dependent object properties and you can create 
the user-defined menus and toolbars in different languages. 


See also 
Editing Pictures with VBA (Page 1654) 
Accessing the component library with VBA (Page 1646) 
Creating Customized Menus and Toolbars (Page 1627) 
Language-Dependent Configuration with VBA (Page 1624) 
VBA in the Graphics Designer (Page 1621) 
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3.3.2.2 


Introduction 


Language-Dependent Configuration with VBA 


With VBA you can carry out configuring in the Graphics Designer for several different 
languages. This gives you access to the language-dependent properties of objects in the 
Graphics Designer, while you can also make the user-defined menus and toolbars available 
in different languages. In VBA, foreign-language texts are stored in a list of the 
"LanguageTexts" type. The settings for language-dependent fonts are stored in a list of the 
"LanguageFonts" type. 


Further information about language-dependent configuring is also provided in the WinCC 
documentation "Setting up multilingual projects". 


User interface language 


Project language 


You can only switch to a different desktop language in WinCC, not with VBA. When you switch 
desktop language in WinCC, the "DesktopLanguageChanged" event is triggered. You can 
adapt the user-defined menus and toolbars to suit the user, for example, by replacing language- 
dependent tool icons. 


The following objects and the associated language-dependent properties react to the switching 
of the user interface language: 


e Folderltem Object 
e Menu object and Menultem object 
e Toolbarltem Object 


e Further information about the desktop language is provided in the WinCC documentation 
"Setting up multilingual projects" under "Language terms in WinCC". 


As of WinCC V7.3, VBA is installed in all languages that you have selected in the WinCC setup. 
When you open the "VBA" editor in the Graphics Designer, the "VBA" editor opens in the same 
user interface language as the Graphics Designer. 


You can change the configuring language with VBA using the "CurrentDataLanguage" 
property. 


In this example the configuring language is changed to "English": 


Sub ChangeCurrentDataLanguage() 


'VBAL 
Application 
sgBox "The 
Application 
sgBox "The 
End Sub 
1624 


.CurrentDataLanguage = 1033 
Data language has been changed to english" 
.CurrentDataLanguage = 1031 
Data language has been changed to german" 


All language-dependent properties, such as ToolTipText, are affected by the change. 
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Configuring for more than one language in VBA 


There are two possible ways for you to carry out configuring for several languages with VBA. 
e@ Language switching: Text properties of objects. 


e Text language lists: Text properties of user-defined menus and toolbars, and objects. 


Language change 

You can change the language-dependent properties (e.g., "Text") of objects with VBA. To do 
this, assign the text to the corresponding property and then change the configuring language 
in order to assign the text in the other language. 

LanguageTexts listing 


You can save the multilingual texts for the respective object directly in the associated listing 
of the "LanguageTexts" type. To do this, enter the language ID for the language and the 
associated text. 


The list of language codes is available in the WinCC documentation (Index > Language Code). 


In this example a German label and an English label are assigned to the button "myButton": 


Sub AddLanguagesToButton () 


"VBA2 


Dim objLabelText As HMILanguageText 

Dim objButton As HMIButton 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMTButton") 
' 


"Set defaultlabel: 
objButton.Text = "Default-Text" 
' 


"Add english 


label: 


Set objLabelText = objButton.LDTexts.Add(1033, "English Text") 


"Add german 


label: 


Set objLabelText = objButton.LDTexts.Add(1031, "German Text") 


End Sub 


See also 


LanguageTexts Object (Listing) (Page 2000) 
LanguageFonts Object (Listing) (Page 1997) 

How to assign help texts to menus and toolbars (Page 1639) 
How to create menus in multiple languages (Page 1633) 
VBA Reference (Page 1745) 
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3.3.2.3 Creating Customized Menus and Toolbars 
Configuring Menus and Toolbars 


Introduction 
You can "liven up" user-defined menus and toolbars so that they respond to certain program 
situations in the Graphics Designer. For example, if an icon is not available because no object 
is selected, you can gray out the icon. A check mark before a menu item can indicate, for 
example, whether a selection is activated. 
The following illustration shows you the configuration possibilities, using the example of a user- 
defined menu: 


Doc_Menu_1 Help Doc_Menu_1 Help 
Object Properties object Properties. 


Grid On/Off ___ulv Grid OnjOFF STRG+G 
_ — S 2 = 


My First Submenu ~> 


Active (yes/no) (1) 
Activates the entry or dims it. You can use the "Enabled" property for user-defined menus, 
menu items and icons: 


"VBA13 
Application.ActiveDocument.CustomMenus (1) .MenuItems(1).Enabled = False 


Marked with check mark (yes/no) (2) 
Marks the menu item with a check mark. You can only use the "Checked" property for user- 
defined menu items: 


'VBA14 
Application.ActiveDocument.CustomMenus (1) .MenuItems (2) .Checked = True 


Shortcut (3) 
Defines a key combination for a menu item or an icon. You can only use the "Shortcut" property 
for user-defined menu items and icons: 


"VBA15 
Application.ActiveDocument.CustomMenus (1) .MenuItems (3) .Shortcut = "Ctr1l+G" 
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Visible (yes/no) (4) 
Displays or hides the item. You can use the "Visible" property for user-defined menus, menu 


items and toolbars and for their icons: 


"VBA16 
Application.ActiveDocument.CustomMenus (1) .MenuItems (4) .Visible = False 


Creating Customized Menus and Toolbars 


User-defined menus and toolbars in the Graphics Designer 
You can use the following user-defined menus and toolbars in the Graphics Designer to run 


VBA macros: 

e User-defined menus and toolbars are always visible when the Graphics Designer is open. 
You should use application-specific menus and toolbars when the VBA macros that are to 
be executed from them have to be accessible at all times. 

Picture-specific menus and toolbars are linked to a specific picture and remain visible for 
as long as the picture is active. You should use picture-specific menus and toolbars when 
the VBA macros used there are relevant only for that particular picture. 
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Positioning of user-defined menus and toolbars 


In the case of user-defined menus, the "Position" parameter determines the final positioning 
in the menu bar: 


Graphics Designer - tablecontrol.PDL 


File Edit View Arrange Tools Window App_Menu_1 App_Menu_2 Pic_Menu_1 Pic_Menu_2 Help 
me Wea” We eee Pletal) 2 EE Rh Qld. 100% in 
> tablecontrol PORE ee ee Ae Ae) en ee ee TT wl th eal i =, 

II-B e 
2-B B 


~ tablecontrol.PDL x_ 


| =: WinCC OnlineTableControl 


© 


‘Ready 10:30:26 


Application-specific menus (1) are always positioned to the right of the "Windows" menu in the 
Graphics Designer, while picture-specific menus (2) are always positioned to the left of the 
"Help" menu in the Graphics Designer. 


However, application-specific toolbars are not treated as "preferred". In this case, the 
positioning is determined by the order in which you insert the toolbars. Toolbars are positioned 
below the Graphics Designer toolbar. 


Properties of user-defined menus and toolbars 


In the case of user-defined menus and toolbars you can use hyphens to divide entries, for 
example according to certain categories. As well as this you can also create submenus in a 
user-defined menu. 


The following configuration options are available to you for user-defined menus and toolbars 
and their entries: 


e Visible (yes/no): Displays or hides the item (visible property). 
e Active (yes/no): Activates the entry or dims it (enabled property). 
@ Marked with check mark (yes/no) - only available for menu command (Checked property). 


@ Shortcut: Key combination for calling a menu command (ShortCut property). 
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See also 


3.3 VBA in the Graphics Designer 


e Statustext: Text that is displayed in the status bar (StatusText property). 
¢@ Tooltip text - only available for an icon (ToolTipText property). 


You can hide a menu command, for example, if the macro cannot be executed at a certain 
time. In this way you can prevent inadvertent wrong operation. 


You can create all texts and labels of user-defined menus and toolbars in multiple languages 
so that the user-defined menus and toolbars can also react to a language change. 


How to assign VBA macros to menus and toolbars (Page 1642) 
How to assign help texts to menus and toolbars (Page 1639) 
How to Add a New Icon to the Toolbar (Page 1637) 

How to Create an Application-specific Toolbar (Page 1635) 

How to create menus in multiple languages (Page 1633) 

How to add a new menu entry to a menu (Page 1631) 

How to Create Picture-specific Menus and Toolbars (Page 1655) 
How to Create a New Application-Specific Menu (Page 1629) 
Configuring Menus and Toolbars (Page 1626) 

Executing VBA Macros in Graphics Designer (Page 1619) 


How to Create a New Application-Specific Menu 


Introduction 


Application-specific menus remain visible even when all pictures in Graphics Designer are 
closed. You can use the Started event, for example, in order to insert an application-specific 
menu at an early stage. 


Position the VBA code either 
e@ inthe "GlobalTemplateDocument" if you want the menu to be available in all projects, or 


e inthe "ProjectTemplateDocument" if you want the menu to be available in the current 
project. 
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Procedure 


Result 


See also 


1630 


1. Open the VBA editor in Graphics Designer (<ALT+F11> or "Tools" > "Macros" > "Visual 
Basic Editor") 


2. In Project Explorer, open the document in which you want to write the VBA code: 


Project - GlobalTemplate x 


Ae |G] : 


GlobalTemplate (C:\\Siemens'\,WinCC\,bin'),@GL! 4 
&3 Graphics Designer Objects 
E3fslobalTemplateDocument (@GLOBAL.PDT) 
ae ProjectTemplate (C:\Siemens',WinCC\, WinCCP 
=|-3 Graphics Designer Objects 
ProjectTemplateDocument (@PROJECT.PDT} x] 


EZ 


3. To create a user-defined menu in the Graphics Designer, you can for example insert a 
"CreateApplicationMenus()" procedure in the document. In this example, two user-defined 
menus are created: 
Sub CreateApplicationMenus () 
"VBA3 
"Declaration of menus...: 
Dim objMenul As HMIMenu 
Dim objMenu2 As HMIMenu 
' 
"Add menus. Parameters are "Position", "Key" und "DefaultLabel": 
Set objMenul = Application.CustomMenus.InsertMenu(1, "AppMenul", 
"App Menu_1") 
Set objMenu2 = Application.CustomMenus.InsertMenu(2, "AppMenu2", 
"App Menu 2") 

End Sub 


4. Start the procedure with <F5>. 


The two menus "App_Menu_1" and "App_Menu_2" are inserted to the right of the "Window" 
menu: 


File Edit View Arrange Tools Window | App Menu_l | App_Menu_2 Help 
: a ne ae WA Oe 


Creating Customized Menus and Toolbars (Page 1627) 
InsertMenu Method (Page 1850) 
How to assign VBA macros to menus and toolbars (Page 1642) 


How to assign help texts to menus and toolbars (Page 1639) 
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How to create menus in multiple languages (Page 1633) 
How to add a new menu entry to a menu (Page 1631) 
Configuring Menus and Toolbars (Page 1626) 
Organizing VBA Code in a WinCC Project (Page 1615) 


How to add a new menu entry to a menu 


Requirements 


You must have created the user-defined menu first. 


Introduction 
You can insert three different types of menu items in the user-defined menu: 
@ Menu entry: To call VBA macros. 
e Separator line: For clearer design of user-defined menu. 
@ Submenu: Same as user-defined menu (e.g. command structuring). 


The "Position" parameter determines the order of the menu items within the user-defined 
menu. 


The "Key" parameter is a unique identification of the menu item. This parameter is used if you 
use the "MenultemClicked" event for calling VBA macros. 


Procedure 


1. Open the VBA editor in Graphics Designer (<ALT+F11> or "Tools" > "Macros" > "Visual 
Basic Editor") 


2. In Project Explorer, open the document in which you want to write the VBA code: 


Project - ProjectTemplate x} 
a . 


GlobalTemplate (C:\\Siemens',WinCC'\,bin',@GLC 
=| 3 Graphics Designer Objects 
GlobalTemplateDocument (@GLOBAL.PDT) 
as ProjectTemplate (C:\Siemens', WinCC\, WinCCPr 
=| Graphics Designer Objects 

ProjectTemplateDocument (@PROJECT.PDT} 
(9 References 
¥BAProject3 (C:\ Siemens), WinCC\, WinCCProjec 
&3 Graphics Designer Objects 

ThisDocument (dynamic_test.PDL} 
(+]-(j References 


i 
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3. To create menu items in a previously created user-defined menu, you can for example 
insert an "InsertMenultems()" procedure in the document. In this example a number of menu 
items are created in the user-defined menu "App_Menu_1": 

Sub InsertMenulItems () 

"VBA4 
Dim objMenul As HMIMenu 

Dim objMenu2 As HMIMenu 

Dim objMenuIteml As HMIMenuItem 

Dim objSubMenul As HMIMenuItem 

"Create Menu: 

Set objMenul = Application.CustomMenus.InsertMenu(1, "AppMenul", 
"App Menu_1") 
"Next lines add menu-items to userdefined menu. 
"Parameters are "Position", "Key" and DefaultLabel: 


Set objMenuIteml = objMenul.MenuItems.InsertMenulItem(1, 
"mIteml 1", "App MenuItem 1") 
Set objMenuIteml = objMenul.MenulItems.InsertMenultem(2, 


"mIteml 2", "App MenuItem 2") 


‘Adds seperator to menu ("Position", "Key") 
Set objMenuIteml = objMenul.MenulItems.InsertSeparator (3, 
"mIteml 3") 


"Adds a submenu into a userdefined menu 
Set objSubMenul = objMenul.Menultems.InsertSubMenu(4, "mIteml 4", 
"App SubMenu_1") 


‘Adds a menu-item into a submenu 

Set objMenuIteml = objSubMenul.SubMenu.InsertMenulItem(5, 
"mIteml 5", "App SubMenulItem 1") 

Set objMenuIteml = objSubMenul.SubMenu.InsertMenultem(6, 
"mIteml 6", "App SubMenulItem 2") 

End Sub 


4. Start the procedure with <F5>. 


Result 


The "InsertWenultems()" procedure inserts the menu "App_Menu_1" with these menu items: 


| App_Menu_t [ff 
App_Menultem_1 Fo Ab 


4pp_Menultem_2 


{ App_SubMenu_1 > App_SubMenultem_1 — 
Ha. avow ono "or God! cae App_SubMenultem_2 “e 
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InsertSeparator Method (Page 1853) 

InsertSubmenu Method (Page 1854) 

InsertMenu Method (Page 1850) 

How to assign VBA macros to menus and toolbars (Page 1642) 
How to assign help texts to menus and toolbars (Page 1639) 
How to create menus in multiple languages (Page 1633) 

How to Create a New Application-Specific Menu (Page 1629) 
Configuring Menus and Toolbars (Page 1626) 

Creating Customized Menus and Toolbars (Page 1627) 


How to create menus in multiple languages 


Introduction 


Procedure 


You can create a user-defined menu that responds to a change of language. To do this you 
need to define the necessary number of labels in other languages for the menu and for each 
menu item. 


The foreign-language label comprises the language ID (LCID) and the foreign-language text 
(DisplayName). 


The list of language codes is available in the WinCC documentation (Index > Language Code). 


1. Open the VBA editor in Graphics Designer (<ALT+F11> or "Tools" > "Macros" > "Visual 
Basic Editor") 


2. In Project Explorer, open the document in which you want to write the VBA code: 


Project - ProjectTemplate x} 
a . 


GlobalTemplate (C:\\Siemens', WinCC' bin’), @GLC 
=| 3 Graphics Designer Objects 
GlobalTemplateDocument (@GLOBAL.PDT) 
as ProjectTemplate (C:\ Siemens‘, WinCC\, WinCCPr 
=| Graphics Designer Objects 
ProjectTemplateDocument (@PROJECT.PDT) 
+)-( 9 References 
se ¥BAProject3 (C:'\Siemens',WinCC', WinCCProjec 
=| 3 Graphics Designer Objects 
ThisDocument (dynamic_test.PDL) 
+|-( 9 References 


| 
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3. To define multilingual labels for a user-defined menu, you can for example insert a 
"Multiple_LanguagesForAppMenu1()" procedure in the document. In this example English 
labels are defined for the "App_Menu_1" menu: 

Sub InsertMenulItems () 

"VBA5 

"Execute this procedure first 

Dim objMenul As HMIMenu 

Dim objMenu2 As HMIMenu 

Dim objMenuIteml As HMIMenuItem 

Dim objSubMenul As HMIMenuItem 

‘Insert Menu: 

Set objMenul = Application.CustomMenus.InsertMenu(1, "AppMenul", 

"App Menu_1") 

"Next lines inserts menu-items to userdefined menu. 

"parameters are "Position", "Key" and DefaultLabel: 

Set objMenuIteml = objMenul.MenulItems.InsertMenultem(1, 

"mIteml 1", "App MenulItem 1") 

Set objMenuIteml = objMenul.MenulItems.InsertMenultem(2, 

"mIteml 2", "App MenuItem 2") 


"Inserts seperator into menu ("Position", "Key") 
Set objMenuIteml = objMenul.MenulItems.InsertSeparator (3, 
"mIteml 3") 


"Inserts a submenu into a userdefined menu 
Set objSubMenul = objMenul.MenuItems.InsertSubMenu(4, "mIteml 4", 
"App SubMenu_1") 


"Inserts a menu-item into a submenu 
Set objMenuIteml = objSubMenul.SubMenu.InsertMenultem(5, 
"mIteml 5", "App SubMenulItem_ 1") 
Set objMenuIteml = objSubMenul.SubMenu.InsertMenultem(6, 
"mIteml 6", "App SubMenulItem 2") 


End Sub 
Sub MultipleLanguagesForAppMenul () 
: execute this procedure after "InsertMenuItems()" was run 


"Object "objLanguageTextMenul" contains the 
"foreign-language labels for the menu 

Dim objLanguageTextMenul As HMILanguageText 
' 
"Object "objLanguageTextMenuliItem" contains the 
"foreign-language labels for the menu-items 

Dim objLanguageTextMenuIteml As HMILanguageText 
Dim objMenul As HMIMenu 
Dim objSubMenul As HMIMenulItem 

Set objMenul = Application.CustomMenus ("AppMenul") 

Set objSubMenul = 
Application.CustomMenus ("AppMenul") .MenulItems ("mIteml 4") 


‘Inserts foreign-language label into a menu: 
"("Add(LCID, DisplayName)" method: 
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Set objLanguageTextMenul = objMenul.LDLabelTexts.Add(1033, 
"English App Menu_1") 


‘Inserts foreign-language label into a menuitem: 
Set objLanguageTextMenuIteml = 
objMenul.MenulItems ("mIteml 1") .LDLabelTexts.Add(1033, "My first 


menu item") 
' 


"Adds a foreign-language label into a submenu: 

Set objLanguageTextMenuIteml = 
objSubMenul.SubMenu.Item("mIteml 5") .LDLabelTexts.Add(1033, "My 
first submenu item") 

End Sub 


4. Start the procedure with <F5>. 


Result 


If you now switch the configuring language to English, certain items in the user-defined menu 
are shown in English. 


See also 
LanguageTexts Object (Listing) (Page 2000) 
LDLabelTexts Property (Page 2299) 
How to assign VBA macros to menus and toolbars (Page 1642) 
How to assign help texts to menus and toolbars (Page 1639) 
How to add a new menu entry to a menu (Page 1631) 
How to Create a New Application-Specific Menu (Page 1629) 
Configuring Menus and Toolbars (Page 1626) 
Creating Customized Menus and Toolbars (Page 1627) 
Language-Dependent Configuration with VBA (Page 1624) 


How to Create an Application-specific Toolbar 


Introduction 


Application-specific toolbars remain visible even when all pictures in the Graphics Designer 
are closed. 


Position the VBA code either 
@ inthe "GlobalTemplateDocument" if you want the toolbar to be available in all projects, or 


e inthe "ProjectTemplateDocument" if you want the toolbar to be available in the current 
project. 
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Procedure 


Result 


See also 


1636 


. Open the VBA editor in Graphics Designer (<ALT+F 11> or "Tools" > "Macros" > "Visual 


Basic Editor") 


. In Project Explorer, open the document in which you want to write the VBA code: 


Project - GlobalTemplate x 
B : 


GlobalTemplate (C:\\Siemens'\,WinCC\,bin'),@GL! 4 
&3 Graphics Designer Objects 
GlobalTemplateDocument (@GLOBAL.PDT} 
ae ProjectTemplate (C:\\Siemens',WinCC', WinCCP 
=|-3 Graphics Designer Objects 
ProjectTemplateDocument (@PROJECT.PDT} x] 
4 


3. To create a user-defined toolbar in the Graphics Designer, you can for example insert a 


"CreateApplicationToolbars()" procedure in the document. In this example two user-defined 
toolbars are created: 

Sub CreateApplicationToolbars () 

"VBA6 

"Declare toolbar-objects...: 

Dim objToolbarl As HMIToolbar 

Dim objToolbar2 As HMIToolbar 

' 


"Add the toolbars with parameter "Key" 

Set objToolbarl = Application.CustomToolbars.Add("AppToolbari") 
Set objToolbar2 = Application.CustomToolbars.Add("AppToolbar2") 
End Sub 


. Start the procedure with <F5>. 


The two toolbars are inserted beneath the Graphics Designer toolbars. 


Add Method (CustomToolbars Listing) (Page 1788) 

How to assign VBA macros to menus and toolbars (Page 1642) 
How to assign help texts to menus and toolbars (Page 1639) 
How to Add a New Icon to the Toolbar (Page 1637) 
Configuring Menus and Toolbars (Page 1626) 

Creating Customized Menus and Toolbars (Page 1627) 
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How to Add a New Icon to the Toolbar 


Requirement 


You must have created the user-defined toolbar first. 


Introduction 
You can insert two different types of objects in the user-defined toolbar: 
@ Symbol: To call VBA macros. 
e Separator line: For clearer design of user-defined toolbars. 
The "Position" parameter determines the order of the icons within the user-defined toolbar. 


The "Key" parameter is a unique identification of the icon. This parameter is used if you use 
the "ToolbarltemClicked" event for calling VBA macros. 


Procedure 


1. Open the VBA editor in Graphics Designer (<ALT+F11> or "Tools" > "Macros" > "Visual 
Basic Editor") 


2. In Project Explorer, open the document in which you want to write the VBA code: 
xf 
EF) : 


GlobalTemplate (C:\\Siemens',WinCC'\,bin',@GLC 
=| 9 Graphics Designer Objects 
GlobalTemplateDocument (@GLOBAL.PDT) 
as ProjectTemplate (C:\\Siemens', WinCC\, WinCCPr 
=| Graphics Designer Objects 
ProjectTemplateDocument (@PROJECT.PDT} 
+) (99 References 
&& ¥YBaProject3 (C:\Siemens\WinCC),WinCCProjec 
=| 3 Graphics Designer Objects 

ThisDocument (dynamic_test.PDL) 
(+]-( 9 References 


i 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 1637 


VBA for Automated Configuration 


3.3 VBA in the Graphics Designer 


Result 


1638 


3. To create icons in a previously created user-defined toolbar, you can for example insert an 
"InsertToolbarltems()" procedure in the document. In this example, two icons separated by 
a separator line are created in the user-defined toolbar "AppToolbar1": 


Sub InsertToolbarItems () 
"VBA7 
Dim objToolbarl As HMIToolbar 


Dim objToolbarIteml As HMIToolbarItem 


"Add a new toolbar: 


Set objToolbarl = Application.CustomToolbars.Add("AppToolbari") 


"Adds two toolbar-items to the toolbar 


"("InsertToolbarItem(Position, 
Set objToolbarIteml = 


DefaultToolTipText) "-Methode) : 


objToolbarl.ToolbarItems.InsertToolbarItem(1, "tIteml 1", "First 


Symbol-Icon") 
Set objToolbarIteml 


obj Toolbarl.Toolbaritems.InsertToolbarItem(3, "tIteml 2", "Second 


Symbol-Icon") 


"Adds a seperator between the two toolbar-items 
"("InsertSeparator (Position, Key) "-Methode): 
Set objToolbarIteml = objToolbarl.ToolbarItems.InsertSeparator (2, 


"tSeparatorl 3") 
End Sub 


4. Start the procedure with <F5>. 


The "InsertToolbarltems()" procedure adds a toolbar with two icons, separated by a dividing 
line, to the Graphics Designer toolbars: 


Graphics Designer - tablecontrol.PDL 


File Edit Yiew Arrange Tools ‘Window 
Be: Oe" oe ee eee ee, 
tablecontrol = a, @ 


Li 


tablecontrol.PDL x 


Note 


Use the icon property in order to specify a graphic (*.ICO format) for a tool icon. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


VBA for Automated Configuration 


See also 


3.3 VBA in the Graphics Designer 


Creating Customized Menus and Toolbars (Page 1627) 

Icon Property (Page 2275) 

InsertSeparator Method (Page 1853) 

InsertToolbarltem Method (Page 1856) 

How to assign VBA macros to menus and toolbars (Page 1642) 
How to assign help texts to menus and toolbars (Page 1639) 
How to Create an Application-specific Toolbar (Page 1635) 
Configuring Menus and Toolbars (Page 1626) 


How to assign help texts to menus and toolbars 


Requirements 


Introduction 


You must have created the user-defined menu or the user-defined toolbar first. 


When the configuring engineer moves the mouse over a user-defined menu item or over a 
user-defined icon, you can provide additional help text to explain the functionality in more detail: 


@ You can define a help text for user-defined menu items and icons; the help text is displayed 
in the status bar. 


e For user-defined icons, the default option is to create the help text as a tooltip. 


You can also define status texts and tooltip texts for other languages. 
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Procedure 


1. Open the VBA editor in Graphics Designer (<ALT+F11> or "Tools" > "Macros" > "Visual 
Basic Editor") 


2. In Project Explorer, open the document in which you want to write the VBA code: 


Project - ProjectTemplate x} 
‘a : 


GlobalTemplate (C:\\Siemens', WinCC\ bin',@GLC 
@9 Graphics Designer Objects 
GlobalTemplateDocument (@GLOBAL.PDT} 
ss ProjectTemplate (C:\\Siemens'\,WinCC\, WinCCPr 
=| Graphics Designer Objects 
ProjectTemplateDocument (@PROJECT.PDT) 
+) (99 References 
ae ¥BAProject3 (C:\ Siemens), WinCC), WinCCProjec 
3 Graphics Designer Objects 
ThisDocument (dynamic_test.PDL) 
(9 References 


fa) 


3. To assign a status text to a user-defined menu item, you can for example insert an 
"AddStatus Texts ToAppMenu1()" procedure in the document. In this example one status 
text in German and one in English is assigned to the first menu item in the previously created 
"AppMenu1" menu: 

Sub AddStatusTextsToAppMenul () 

'VBA8 
Dim objMenul As HMIMenu 
' 
"Object "objStatusTextMenulItem1" contains foreign-language texts 
Dim objStatusTextMenulIteml As HMILanguageText 

Set objMenul = Application.CustomMenus ("AppMenul") 


"Assign a statustext to a menuitem: 
objMenul.Menultems ("mIteml 1") .StatusText = "Statustext the first 


menuitem" 
' 


"Assign a foreign statustext to a menuitem: 

Set objStatusTextMenuIteml = 
objMenul.Menultems ("mIteml_ 1") .LDStatusTexts.Add(1033, "This is 
my first status text in English") 

End Sub 
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4. To assign status and foreign-language tool tip text to a user-defined icon on the toolbar, 
insert a "AddStatusAndTooltipTextsToAppToolbar1()" procedure in the document, for 
example. In this example, the first icon on the toolbar created is assigned a status text 
(German/English) and an English tool tip text: 

Sub AddStatusAndTooltipTextsToAppToolbarl () 

"VBA9 

Dim objToolbarl As HMIToolbar 

' 

"Variable "StatusTextToolbarIteml" for foreign statustexts 

Dim objStatusTextToolbarIteml As HMILanguageText 

' 

"Variable "TooltipTextToolbarIteml for foreign tooltiptexts 

Dim objTooltipTextToolbarIteml As HMILanguageText 

Set objToolbarl = Application.CustomToolbars ("AppToolbari") 


"Assign a statustext to a toolbaritem: 
objToolbarl.ToolbariItems ("tIteml 1") .StatusText = "Statustext fur 
das erste Symbol-Icon" 
' 

"Assign a foreign statustext to a toolbaritem: 

Set objStatusTextToolbarIteml = 
objToolbarl.ToolbariItems ("tIteml 1") .LDStatusTexts.Add(1033, 


"This is my first status text in English") 
' 


"Assign a foreign tooltiptext to a toolbaritem: 

Set objTooltipTextToolbarIteml = 
objToolbarl.ToolbariItems ("tIteml 1") .LDTooltipTexts.Add(1033, 
"This is my first tooltip text in English") 

End Sub 


5. Start the procedure with <F5>. 


Results 


The status text is displayed when you move the mouse pointer over the user-defined menu 
item or the icon. 


See also 
LDTooltipTexts Property (Page 2303) 
LDStatusTexts Property (Page 2301) 
LanguageTexts Object (Listing) (Page 2000) 
Add Method (Page 1786) 
How to assign VBA macros to menus and toolbars (Page 1642) 
How to Add a New Icon to the Toolbar (Page 1637) 
How to add a new menu entry to a menu (Page 1631) 
Configuring Menus and Toolbars (Page 1626) 
Creating Customized Menus and Toolbars (Page 1627) 
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How to assign VBA macros to menus and toolbars 


Introduction 


Procedure 


1642 


There are two possible ways for you to assign VBA macros to user-defined menus and toolbars: 


e You can use either the VBA event handlers "MenultemClicked" and "ToolbarltemClicked" 


or 


e@ "Macro" property. 


Note 


You will find the VBA code for creating the required user-defined menus and toolbars in 
this documentation under "Adding a New Menu Item to a Menu" and "Adding a New Icon 
to a Toolbar". 


Assigning a VBA macro with a VBA event handler 


Note 


You will find further information on VBA event handlers in this documentation under "Event 


Handling". 


1. Open the VBA editor in Graphics Designer (<ALT+F11> or "Tools" > "Macros" > "Visual 
Basic Editor") 


2. In Project Explorer, open the document in which you want to write the VBA code: 


Project - ProjectTemplate x} 
. 


E} 


GlobalTemplate (C:\\Siemens',WinCC\,bin',@GLC 
3 Graphics Designer Objects 
GlobalTemplateDocument (@GLOBAL.PDT) 


as ProjectTemplate (C:\ Siemens’, WinCC\, WinCCPr 


3 Graphics Designer Objects 
ProjectTemplateDocument (@PROJECT.PDT} 


+ 


(9 References 


as ¥BAProject3 (C:\,Siemens',WinCC', WinCCProjec 


£3 Graphics Designer Objects 
ThisDocument (dynamic_test.PDL} 


[+)-(9 References 


| 


3. To start a VBA macro via the VBA event handlers, use the "MenultemClicked" or 
"ToolbarltemClicked" event: 


4. Insert the VBA code from the "VBA10" table. 
5. Start the procedure with <F5>. 
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Assigning a VBA Macro using the "Macro" property 


1. Open the VBA editor in Graphics Designer (<ALT+F11> or "Tools" > "Macros" > "Visual 
Basic Editor") 


2. In Project Explorer, open the document in which you want to write the VBA code: 


Project - ProjectTemplate x} 
a . 


GlobalTemplate (C:\\Siemens',WinCC'\,bin',@GLC 
=| 3 Graphics Designer Objects 
GlobalTemplateDocument (@GLOBAL.PDT) 
as ProjectTemplate (C:\Siemens', WinCC\, WinCCPr 
=| 3 Graphics Designer Objects 

ProjectTemplateDocument (@PROJECT.PDT) 
(9 References 
¥BAProject3 (C:',Siemens',WinCC', WinCCProjec 
& Graphics Designer Objects 

ThisDocument (dynamic_test.PDL) 
+]-( 9 References 


i 


3. To start a VBA macro via the Macro property, assign the VBA macro to each menu item or 
icon. In the following example, a user-defined menu with two menu entries is created, which 
retrieve two different VBA macros: 

The VBA code of the following VBA11 example depends on the file type. The VBA code is 
added as an example for a PDL and a PDT file. Both cases can be distinguished in the 
following manner: 


— PDL file: 
The VBA code in a PDL file is only executed when this PDL file is being displayed. 


— PDT file: 
The VBA code in a PDT file is always executed when the Graphics Designer is open. 


4. Insert the VBA code from the "VBA11" table. Sample code for PDL file or"VBA821: Sample 
code for PDT file". 
You can call the following two procedures via the menu items in the user-defined menu 
"DocMenu1": 


5. Insert the VBA code from the "VBA12" table. 
6. Start the procedure with <F5>. 


The following tables show the VBA codes for the example: 
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Start VBA via event handler (VBA10) 


Option Explicit 
"VBA10 
'The next declaration has to be placed in the module section 
Dim WithEvents theApp As grafexe.Application 


Private Sub SetApplication() 


"This procedure has to be executed (with "F5") first 
Set theApp = grafexe.Application 
End Sub 


Private Sub theApp MenultemClicked(ByVal MenulItem As IHMIMenulItem) 
Dim objClicked As HMIMenuItem 

Dim varMenulItemKey As Variant 

Set objClicked = MenuItem 


'"vyarMenultemKey" contains the value of parameter "Key" 
"from clicked menu-item 

varMenulItemKey = objClicked.Key 

Select Case varMenultemKey 

Case "mIteml 1" 

sgBox "The first menuitem was clicked!" 

End Select 

End Sub 


Private Sub theApp ToolbarItemClicked (ByVal ToolbarItem As IHMIToolbarItem) 
Dim objClicked As HMIToolbarItem 

Dim varToolbarItemKey As Variant 

Set objClicked = ToolbarItem 


'vyarToolbariItemKey" contains the value of parameter "Key" 
"from clicked toolbar-item 

varToolbarItemKey = objClicked.Key 

Select Case varToolbarItemKey 

Case "tIteml 1" 

sgBox "The first symbol-icon was clicked!" 

End Select 

End Sub 
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Creating a menu (VBA11: Sample code for PDL file) 


Sub CreateDocumentMenusUsingMacroProperty () 

'VBA11 

Dim objDocMenu As HMIMenu 

Dim objMenuItem As HMIMenulItem 

Set objDocMenu = ActiveDocument.CustomMenus.InsertMenu(1, "DocMenul", 
"Doc Menu_1") 

Set objMenuItem = objDocMenu.MenulItems.InsertMenuItem(1, "dmIteml_ 1", 
"First Menuitem") 

Set objMenuItem = objDocMenu.MenuItems.InsertMenuItem(2, "dmIteml 2", 


"Second Menuitem") 
' 


"Assign a VBA-macro to every menu item 
With ActiveDocument.CustomMenus ("DocMenul") 


-MenulItems ("dmIteml_ 1") .Macro = "TestMacrol" 
-Menultems("dmIteml 2") .Macro = "TestMacro2" 
End With 

End Sub 


Creating a menu (VBA821: Sample code for PDT file) 


Sub CreateDocumentMenusUsingMacroProperty () 
"VBA821 
Dim objDocMenu As HMIMenu 

Dim objMenuItem As HMIMenulItem 

Set objDocMenu = Application.CustomMenus.InsertMenu(1, "DocMenul", 
"Doc Menu_1") 

Set objMenuItem = objDocMenu.MenuItems.InsertMenuItem(1, "dmIteml 1", 
"First Menuitem") 

Set objMenuItem = objDocMenu.MenuItems.InsertMenuItem(2, "dmIteml 2", 


"Second Menuitem") 
' 


"Assign a VBA-macro to every menu item 
With Application.CustomMenus ("DocMenul") 


-MenulItems ("dmIteml_1").Macro = "TestMacrol" 
-Menultems ("dmIteml 2") .Macro = "TestMacro2" 
End With 

End Sub 


Macros for user-defined menu entries (VBA12) 


Sub TestMacrol () 

'VBA12 

sgBox "TestMacrol was executed" 
End Sub 


Sub TestMacro2 () 
sgBox "TestMacro2 was executed" 
End Sub 
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See also 
Macro Property (Page 2320) 
ToolbarltemClicked Event (Page 1782) 
MenultemClicked Event (Page 1775) 
How to Add a New Icon to the Toolbar (Page 1637) 
How to add a new menu entry to a menu (Page 1631) 
Event Handling (Page 1709) 
Executing VBA Macros in Graphics Designer (Page 1619) 


3.3.2.4 Accessing the component library with VBA 


Accessing the component library with VBA 


Introduction 


The component library contains a large selection of ready-made objects which you can use to 
design your screens efficiently. The component library consists of a global library and a project- 
related library: 


@ The "Global Library" contains prepared objects that are supplied with WinCC. The objects 
are filed in folders, sorted according to subjects, such as valves, motors, cables and many 
others. 


e The "Project Library" contains neither objects nor folders when you have created a new 
project. You can create objects which you need only in this particular project in the "Project 
Library”. 


VBA gives you full access to the component library: You can create and delete folders and 
save objects in the component library or insert them into pictures. 


Access to the component library with VBA 
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The component library is represented in VBA by the "SymbolLibraries" listing. The listing 
contains two elements, which represent the "Global Library" and the "Project Library". The 
"Folderltems" listing contains elements, which represent folders as well as objects. 


Note 


To address an object in the "SymbolLibraries" listing you use either the index number or the 
internal name. 


You can find out the internal name by clicking the right mouse button on the relevant object in 
the component library and then choosing the "Copy path" command in the pop-up menu. 


The path to the object within the component library is then copied to the clipboard. 


M& Library C:\Program Files\Siemens\WinCC\winCCProjects\Test01\ 


@—————_;> Global Library 
&-() Displays 
(3 Operation 
=) PlantElements 
(9 Motors 


l| #-( Pipes 

GB) Loy PIpes = Smart Ubjects 
(5) Pumps — — 
4 Tanks Screen WinCC1 Screen WinCCc2 
(| valves 

(Valves - Smart Objects 
4 (4 Siemens HMI Symbol Library 1.4.1 
)-() Symbols 
@ Project Library 


GF) EE) A) 


Global Library (1) 


The "Global Library" is the first element in the SymbolLibraries listing, which you address using 
index number "1". You address the "Project Library" using index number "2". 


Access to the "Global Library" with VBA: 


"VBA17 
Application.SymbolLibraries (1) 


Folder (2) 


A folder in the component library contains either other folders or the objects of a particular 
subject area. In VBA a folder corresponds to the "Folderltem" object and its type is "Folder". 
The folders are contained in the "Folderltems" listing. With VBA you can create a new folder 
or delete an existing one, and add an object to the folder via the clipboard. 


Access to the "Plant Components" folder with VBA: 


'VBA18 
Application.SymbolLibraries (1) .FolderItems ("Folder2") 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 1647 


VBA for Automated Configuration 
3.3 VBA in the Graphics Designer 


Object (3) 


In VBA an object corresponds to the "Folderltem" object and its type is "Item". The objects are 
contained in the "Folder" listing. With VBA you can delete an object or copy it to the clipboard. 


Access to the "PC" object with VBA: 


"VBA19 
Application.SymbolLibraries (1) .FolderItems ("Folder2") .Folder ("Folder2") .Folder.Item("Objec 
t1") .DisplayName 


Creating or deleting folders in the component library 
Use the following methods to create or delete folders: 


e "AddFolder(DefaultName)" Method: Creates a new folder in the components library. A 
newly created folder receives the internal name "FolderX", where "X" stands for a 
consecutive number. 


e "Delete()" Method: Deletes an existing folder (including all folders and objects that it 
contains) from the component library. 


Inserting or deleting an object in the component library 


You can copy objects within the component library (for example from the "Global Library" to 
the "Project Library"), insert an object from a picture into the component library or delete an 
object from the component library: 


@ Methoden "CopyToClipboard()" und "AddFromClipboard()": Copies an object to the 
clipboard within the component library. 


e "Additem(DefaultName, pHMIObject)" method: Copies an existing object in the picture into 
a folder in the component library. 


e "Delete()" Method: Deletes an object. 


Finding an object or folder in the component library 


Use the "FindByDisplayName("DisplayName") method to search for an object or folder. The 
specified display name is dependent on which language is currently set. The search ends with 
the first occurrence of the object or folder that you are looking for. 


Inserting an object into a picture from the component library 


Use the "CopyToClipboard()" and "PasteClipboard()" methods to insert an object from the 
component library into the current picture. 


See also 
CopyToClipboard Method (Page 1824) 
PasteClipboard Method (Page 1868) 
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GetltemByPath Method (Page 1847) 

FindByDisplayName Method (Page 1842) 

Delete Method (Page 1831) 

Addltem Method (Page 1802) 

AddFromClipboard Method (Page 1799) 

AddFolder Method (Page 1798) 

SymbolLibrary Object (Page 2074) 

SymbolLibraries Object (Listing) (Page 2073) 

How to paste an object from the object library into a picture with VBA (Page 1652) 
How to edit the component library with VBA (Page 1649) 


How to edit the component library with VBA 


Introduction 
Here you will find the following instructions for editing the component library with VBA: 
@ Creating a new folder 
@ Copying an object within the component library 
@ Copying an object from the active picture into the component library 
e Deleting an object from the component library 
Procedure 


1. Open the VBA editor in Graphics Designer (<ALT+F11> or "Tools" > "Macros" > "Visual 
Basic Editor") 


2. In Project Explorer, open the document in which you want to write the VBA code: 


Project - ProjectTemplate : x| 
a . 


GlobalTemplate (C:\\Siemens',WinCC'\,bin',@GLC 
=| 3 Graphics Designer Objects 
GlobalTemplateDocument (@GLOBAL.PDT) 
as ProjectTemplate (C:\\Siemens', WinCC\, WinCCPr 
=| Graphics Designer Objects 
ProjectTemplateDocument (@PROJECT.PDT) 
+)-( 9 References 
se ¥BAProject3 (C:\ Siemens), WinCC\, WinCCProjec 
=| 3 Graphics Designer Objects 
ThisDocument (dynamic_test.PDL) 
+|-( 9 References 


| 
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3. To create a new folder in the component library, you can for example insert an 
"AddNewFolderToProjectLibrary()" procedure in the document. In this example the folder 
"My folder" is created: 

Sub AddNewFolderToProjectLibrary () 

"VBA20 

Dim objProjectLib As HMISymbolLibrary 

Set objProjectLib = Application.SymbolLibraries (2) 


'("AddFolder (DefaultName) "-Methode) : 
obj ProjectLib.FolderItems.AddFolder ("Custom Folder") 
End Sub 


4. In order to copy an object from the "global library" to the "library project", insert a 
"CopyObjectFromGlobalLibraryToProjectLibrary()" procedure in the document, for 
example. In this example, the object "Object1" is copied: 

Sub CopyObjectFromGlobalLibraryToProjectLibrary () 

"VBA21 
Dim objGlobalLib As HMISymbolLibrary 

Dim objProjectLib As HMISymbolLibrary 

Set objGlobalLib = Application.SymbolLibraries (1) 
Set objProjectLib = Application.SymbolLibraries (2) 


"Copies object "PC" from the "Global Library" into the clipboard 
objGlobalLib.FolderItems ("Folder2") .Folder("Folder2") .Folder.Item ( 
"Object1") .CopyToClipboard 

' 

'The folder "Custom Folder" has to be available 

obj ProjectLib.FolderItems ("Folderi") .Folder.AddFromClipBoard 
("Copy of PC/PLC") 

End Sub 


5. In order to copy an object from the active picture to the "Project Library", insert a procedure 
like "AddObjectFromPictureToProjectLibrary()" into document. In this example, the object 
"Circle1" is created in the active picture and then copied to the folder "Folder1": 

Sub AddObjectFromPictureToProjectLibrary () 

"VBA22 
Dim objProjectLib As HMISymbolLibrary 

Dim objCircle As HMICircle 

Set objProjectLib = Application.SymbolLibraries (2) 


"Insert new object "Circlel" 
Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circlel", 
"HMTCircle") 


'The folder "Custom Folder" has to be available 
'("AddItem(DefaultName, pHMIObject) "-Methode): 
objProjectLib.FolderItems ("Folderl") .Folder.AddItem "ProjectLib 
Circle", ActiveDocument.HMIObjects ("Circlel") 

End Sub 
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See also 
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6. Todelete an object from the componentlibrary, insert a"DeleteObjectFromProjectLibrary()" 
procedure in the document, for example. In this example the previously created folder 
"Folder1" is deleted: 

Sub DeleteObjectFromProjectLibrary () 

'VBA23 

Dim objProjectLib As HMISymbolLibrary 

Set objProjectLib = Application.SymbolLibraries (2) 
' 


'The folder "Custom Folder" has to be available 
"Delete" Method: 
objProjectLib.FolderItems ("Folderi") .Delete 

End Sub 


7. Start the procedure with <F5>. 


SymbolLibrary Object (Page 2074) 

SymbolLibraries Object (Listing) (Page 2073) 

PasteClipboard Method (Page 1868) 

Delete Method (Page 1831) 

CopyToClipboard Method (Page 1824) 

Addltem Method (Page 1802) 

AddFromClipboard Method (Page 1799) 

AddFolder Method (Page 1798) 

How to paste an object from the object library into a picture with VBA (Page 1652) 
Accessing the component library with VBA (Page 1646) 
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How to paste an object from the object library into a picture with VBA 


Procedure 


1. Open the VBA editor in Graphics Designer (<ALT+F11> or "Tools" > "Macros" > "Visual 
Basic Editor") 


2. In Project Explorer, open the document in which you want to write the VBA code: 


Project - ProjectTemplate as 
El : 


GlobalTemplate (C:\Siemens',WinCC\ bin',@GLC 
=| Graphics Designer Objects 
GlobalTemplateDocument (@GLOBAL.PDT} 
a ProjectTemplate (C:\Siemens',WinCC',WinCCPr 
=| 29 Graphics Designer Objects 
ProjectTemplateDocument (@PROJECT.PDT) 
+] (9 References 
ee ¥BAProject3 (C:\ Siemens), WinCC), WinCCProjec 
=| Graphics Designer Objects 
ThisDocument (dynamic_test.PDL) 
+) (9 References 


P| 
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3. To insert an object from the "Global Library" into the active picture, you can for example 
insert a "CopyObjectFromGlobalLibraryToActiveDocument()" procedure in the document. 
In this example the object "Object1" is inserted 
Sub CopyObjectFromGlobalLibraryToActiveDocument () 
"VBA24 
Dim objGlobalLib As HMISymbolLibrary 
Dim objJHMIObject As HMIObject 
Dim iLastObject As Integer 
Set objGlobalLib = Application.SymbolLibraries (1) 


"Copy object "PC" from "Global Library" to clipboard 
objGlobalLib.FolderItems ("Folder2") .Folder ("Folder2") .Folder.Item( 
"Object1") .CopyToClipboard 

' 

"Get object from clipboard and add it to active document 
ActiveDocument.PasteClipboard 

' 

"Get last inserted object 

iLastObject = ActiveDocument.HMIObjects.Count 

Set objJHMIObject = ActiveDocument.HMIObjects (iLastObject) 

' 
"Set position of the object: 
With objJHMIObject 

-Left = 40 

-Top = 40 
End With 
End Sub 


4. Start the procedure with <F5>. 


See also 
PasteClipboard Method (Page 1868) 
CopyToClipboard Method (Page 1824) 
How to edit the component library with VBA (Page 1649) 
Accessing the component library with VBA (Page 1646) 
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3.3.3 Editing Pictures with VBA 
3.3.3.1 Editing Pictures with VBA 
Introduction 


Pictures visualize the process to be executed and observed. They display the important 
process steps or plant parts and present the production process in a schematic manner. In 
VBA the picture is represented by the Document object. 


Picture-specific menus and toolbars 
In contrast with the application-specific menus and toolbars, the picture-specific menus and 
toolbars are coupled to a specific picture. The picture-specific menus and toolbars remain 
visible for as long as the picture is active. 
You should use picture-specific menus and toolbars when the called VBA macros are only 
used in that picture. 


Layers 
You can access the layers in the Graphics Designer with VBA. Each layer is represented by 
the Layer object. By changing the properties of the Layer object you can specify among other 
things the layer names and the zoom settings. 
You control the visibility of the RT layers via the Document object. You control the visibility of 
the CS layers via the View object. 


Copies of the picture 


You can create copies of a picture with VBA in order to display different views of a picture. The 
copy of a picture is represented in VBA by the View object. 
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See also 


3.3.3.2 


Introduction 


Procedure 


3.3 VBA in the Graphics Designer 


Inthe properties of the View object you can among other things set the zoom factor and specify 
which picture section is to be displayed. 


Note 


If you want to run VBA code in a picture saved in WinCC V7.0 SP1 under WinCC V7.0, you 
need to deactivate the "CCHMIDotNetObj 1.0 Type Library" in the VBA Editor under "Tools > 
References". 


The VBA program will then be executed within the usual functional scope of WinCC V7.0. In 
this case, you cannot use the new functions of WinCC V7.0 SP1. 


Editing a Copy of a Picture with VBA (Page 1658) 

How to Create Picture-specific Menus and Toolbars (Page 1655) 
Editing Layers with VBA (Page 1657) 

Editing Objects with VBA (Page 1660) 

Adapting the Graphics Designer with VBA (Page 1623) 


How to Create Picture-specific Menus and Toolbars 


Picture-specific menus and toolbars are linked to a specific picture and remain visible for as 
long as the You should use picture-specific menus and toolbars when the VBA macros used 
there are relevant only for that particular picture. 


1. Open the VBA editor in Graphics Designer (<ALT+F11> or "Tools" > "Macros" > "Visual 
Basic Editor"). 


2. Open the document "ThisDocument" in the Project Explorer: 


Project - ¥BAProject3 x 
ia : 


GlobalTemplate (C:\\Siemens',WinCC\ 
ss ProjectTemplate (C:\Siemens'\,WinCC' 
as ¥BAProject3 (C:\\Siemens',WinCC', Win 
=| 3 Graphics Designer Objects 
ThisDocument (dynamic_test.PDL) 
+]-(9 References 
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See also 
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3. To create a picture-specific menu, you can for example insert a "CreateDocumentMenus()" 
procedure in the document "ThisDocument": 
Sub CreateDocumentMenus () 
"VBA25 
"Declare menuobjects: 
Dim objMenul As HMIMenu 
Dim objMenu2 As HMIMenu 
"Insert Menus ("InsertMenu"-Methode) with 
"Parameters - "Position", "Key", "DefaultLabel": 
Set objMenul = ActiveDocument.CustomMenus.InsertMenu (1, 
"DocMenul", "Doc Menu 1") 
Set objMenu2 = ActiveDocument.CustomMenus.InsertMenu (2, 
"DocMenu2", "Doc Menu 2") 

End Sub 


4. In order to create a picture-specific toolbar, insert a procedure like 
"CreateDocumentToolbars()" into the document "ThisDocument": 
Sub CreateDocumentToolbars () 

"VBA26 

"Declare required number of toolbarobjects: 
Dim objToolbarl As HMIToolbar 

Dim objToolbar2 As HMIToolbar 


"Insert toolbars ("Add"-Methode) with 

"Parameter - "Key": 

Set objToolbarl = ActiveDocument.CustomToolbars.Add("DocToolbari") 
Set objToolbar2 ActiveDocument.CustomToolbars.Add("DocToolbar2") 
End Sub 


5. Always start the procedure with <F5>. 


Add Method (CustomToolbars Listing) (Page 1788) 

InsertMenu Method (Page 1850) 

How to assign VBA macros to menus and toolbars (Page 1642) 
How to assign help texts to menus and toolbars (Page 1639) 
How to Add a New Icon to the Toolbar (Page 1637) 

How to create menus in multiple languages (Page 1633) 

How to add a new menu entry to a menu (Page 1631) 

Creating Customized Menus and Toolbars (Page 1627) 
Configuring Menus and Toolbars (Page 1626) 
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3.3.3.3 Editing Layers with VBA 


Introduction 


You can arrange objects in 32 layers in the Graphics Designer. The layers are differentiated 
according to CS layers and RT layers so that the visibility of the layers in the picture (CS) and 
in runtime (RT) can be controlled separately. In VBA a layer is represented by the Layer object: 


In the Graphics Designer the lowest layer is "Layer 0". To give back the lowest layer with VBA, 
use the index "1": 


ActiveDocument. Layers (1) 


Using the Layer object 


You use the Layer object in order to specify the minimum and maximum zoom for a layer and 
to assign a name. In the following example the settings for the lowest layer are configured in 
the active picture: 


Sub ConfigureSettingsOfLayer 
'VBA27 

Dim objLayer As HMILayer 

Set objLayer = ActiveDocument.Layers (1) 
With objLayer 

"Configure "Layer 0" 

-MinZoom = 10 

.MaxZoom = 100 

-Name = "Configured with VBA" 
End With 

End Sub 


Controlling the visibility of CS and RT layers 


You control the visibility of the CS layers via the View object. Use the Document object in order 
to determine which layers are to be displayed or hidden in runtime. You can control the visibility 
of the CS and RT layers with the following methods: 


e Methode "IsCSLayerVisible(Index)": Checks whether the specified CS layer is displayed. 
@ Methode "SetCSLayerVisible(Index, Val)": Shows or hides the specified CS layer. 
Use the IsRTLayerVisible and SetRTLayerVisible methods for the RT layers in the same way. 
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See also 
IsRTLayerVisible Method (Page 1858) 
SetRTLayerVisible Method (Page 1887) 
SetCSLayerVisible Method (Page 1885) 
IsCSLayerVisible Method (Page 1857) 
Layers Object (Listing) (Page 2003) 
Editing Pictures with VBA (Page 1654) 
Language-Dependent Configuration with VBA (Page 1624) 


3.3.3.4 Editing a Copy of a Picture with VBA 


Introduction 


You can create copies of a picture with VBA in order to display different views of a picture. 
Each view is shown in a separate window. The copy of a picture is represented in VBA by the 
View object: 


Inthe properties of the View object you can among other things set the zoom factor and specify 
which picture section is to be displayed. 


Creating a copy of a picture 


Use the Add method to create a copy of the specified picture. In this example a copy of the 
active picture is created and activated: 


Sub CreateAndActivateView () 

"VBA28 

Dim objView As HMIView 

Set objView = ActiveDocument.Views.Add 
objView.Activate 

End Sub 
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Editing a copy of a picture 


You can edit each copy of a screen as follows: 


e Adjust zoom factor: Use the zoom property. 


3.3 VBA in the Graphics Designer 


@ Specify picture zoom area: Specify the picture section: use the "ScrollPosX" and 
"ScrollPosY" properties to specify the picture zoom area using the scroll bars. 


@ Showing and Hiding CS layers: You can use the SetCSLayerVisible(Index) method for 
example to show or hide the specified layer. You can select the layer on which you want 


to edit the objects with the ActiveLayer property. 


In the following example a copy of the active picture is created and activated. The zoom factor 


is set to 150% and the position of the scrollbars is changed: 


Sub SetZoomAndScrollPositionInActiveView () 
"VBA29 

Dim objView As HMIView 

Set objView = ActiveDocument.Views.Add 
With objView 

-Activate 

-ScrollPosxX = 40 

-ScrollPosY = 10 

-Zoom = 150 

End With 

End Sub 


See also 
Add Method (Views Listing) (Page 1793) 
ScrollPosY Property (Page 2411) 
ScrollPosX Property (Page 2410) 
ActiveLayer Property (Page 2108) 
View Object (Page 2102) 
SetCSLayerVisible Method (Page 1885) 
IsCSLayerVisible Method (Page 1857) 
Activate Method (Page 1785) 
Editing Layers with VBA (Page 1657) 
Editing Pictures with VBA (Page 1654) 
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3.3.4 


3.3.4.1 


Editing Objects with VBA 


Editing Objects with VBA 


Access to objects in the Graphics Designer 


In VBA all object types of the current picture are contained in the "HMIObjects" listing. They 
are not divided according to object type (Standard, Smart, Windows and Controls objects) as 
in the Graphics Designer. With VBA you can therefore run through all objects in one or more 
pictures with a loop. 


When you have selected objects in the picture, these objects are contained in the "Selection" 
listing. Use the "HMIDefaultObjects" listing if you want to change the default settings of the 
properties of an object. 


To address an object in a picture with VBA, use either the object name, e.g. 
"ActiveDocument.HMlObjects("Circle1"), or the index number. " 
ActiveDocument.HMlObjects(1)" references for example the first object in the active picture. 


Editing objects with VBA 


1660 


You have the following possibilities for editing objects with VBA: 
@ Create a new object in a picture 

e Delete an existing object 

e Copy an existing object 

® Group existing objects or cancel the grouping 

e Search for objects 

e Display or change object properties 


When you insert a new object into a picture with VBA, the object behaves in the same way as 
if you double-clicked it in the Graphics Designer object palette. 


The object is given the predefined property values and is inserted in the top left-hand corner 
of the picture. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


VBA for Automated Configuration 
3.3 VBA in the Graphics Designer 


Access to the object properties is dependent on how you created the object. Two examples 
illustrate this: 


Example 1: 


In this example a circle of the type "HMIObject" is inserted into the current picture. You can 
use a VBA object of the "HMIObject" type or all objects in the Graphics Designer. However, 
you have to address individual properties of the respective object explicitly via the 
"Properties(Index)" property: 


Sub AddObject () 

"VBA30 

Dim objObject As HMIObject 

Set objObject = ActiveDocument.HMIObjects.AddHMIObject ("CircleAsHMIObject", "HMICircle") 


"standard-properties (e.g. the position) are available every time: 
objObject.Top = 40 
objObject.Left = 40 


"non-standard properties can be accessed using the Properties-collection: 
objObject. Properties ("FlashBackColor") = True 
End Sub 


Example 2: 


In this example a circle of the type "HMICircle" is inserted into the current picture. In contrast 
with Example 1 you can only use the "objCircle" object for objects of the "HM|ICircle" type, 


however: 
Sub AddCircle() 
'VBA31 
Dim objCircle As HMICircle 
Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("CircleAsHMICircle", "HMICircle") 


'The same as in example 1, but here you can set/get direct th 
"specific properties of the circle: 

objCircle.Top = 80 

objCircle.Left = 80 

objCircle.FlashBackColor = True 

End Sub 


See also 
LanguageFonts Object (Listing) (Page 1997) 
VBA Reference (Page 1745) 
Underlined Property (Page 2460) 
Size Property (Page 2419) 
Parent Property (Page 2359) 
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LanguagelD Property (Page 2289) 
Italic Property (Page 2282) 

Family Property (Page 2229) 

Bold Property (Page 2151) 
Application Property (Page 2121) 


3.3.4.2 Default objects, Smart objects, Windows objects and Tube objects 


Default objects, Smart objects, Windows objects and Tube objects 


Introduction 


You use the Standard, Smart and Windows objects to design your pictures. In the Graphics 
Designer, these objects are available in the "Default" selection window: 


1] | 


=)-.eg Standard Objects (8 Standard Objects (8 Standard Objects 
ton / Line =| = Smart Objects (=) Smart Objects 
4 Polygon iG Application Window 44 Windows Objects 
“\, Polyline {7] Picture Window ) Button 
-@® Ellipse Att} Control %= Check Box 
© Circle OLE] OLE Element $= Option Group 
@ Ellipse Segment 1/0 Field J Round Button 
( Pie Segment (JE Bar == Slider Object 
> Ellipse Arc i 2a} Graphic Object =) Tube objects 
C Circular Arc 3 Status Display == Polygon tube 
1) Rectangle in Text List =P T-piece 
) Rounded Rectangle AS Multiple row text # Double T-piece 
A Static Text "3 Combobox S\\ Tube bend 
2! Connector 28 List box 
(}~) Smart Objects I) Faceplate instance 
f)~-4_4 Windows Objects ze) .NET Control 
(4, Tube objects &-) WPF Control 
J 3D-Bar 
4) Group Display 
4.4 Windows Objects 
3) a Tube objects 
| AD stanaara |TE)Controis [EE styles | | AP stanaara |TE)Controls |Z= styles | | AP standara |[E)Controls | B= styles 


VBA enables you to access these objects in all pictures in your project. If, for example, you 
want to change the background color of all circles in a project with several pictures, you can 
do this with a VBA macro. 
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Paste Object into Picture 


Use the "AddHMlObject(ObjectName, ProgID)" method to insert a new object in a picture. 
ObjectName" stands for the name of the object (e.g. "my Circle"), and "ProgID" for the VBA 
object designation (e.g. "HM|ICircle"): 


Sub AddCircle() 

"VBA32 

"Creates object of type "HMICircle" 
Dim objCircle As HMICircle 

' 


‘Add object in active document 
Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("My Circle", "HMICircle") 
End Sub 


Edit Object 


VBA gives you access to all object properties, which you can edit via the object's properties 
dialog. You can change and output object properties, and select objects in the picture. If you 
have not selected an object, you can use the following methods: 


e "Find()" method: Searches for an object in the "HMIObjects" listing 
e "Delete()" Method: Deletes an HMlObject object. 


If you have selected objects, you can edit them via the "Selection" listing with the following 
methods, among others: 


e "AlignLeft()", "AlignRight()", "AlignTop()", "AlignBottom()": These methods align objects. 


e "CreateGroup()", "CreateCustomizedObject()": These methods create a group object or 
customized object. 


e "DeselectAll()" method: Cancels the selection of all objects 


Remove VBA:references with "Nothing" 


Always remove the references used for the Controls, the standard objects, and for the 
document after you closed the document. For this purpose, set the objects to "Nothing". The 
following example shows the code for a Control: 
Public Sub DrawNewControl 
Const strFct = "CreatePdls" 
Dim objControl As HMIObject 
Dim objDoc As Document 
On Local Error GoTo errorhandler 
"open the document 
Set objDoc = 
grafexe.Application.Documents.Open(grafexe.Application.ApplicationDa 
taPath & "PDL1.pdl", hmiOpenDocumentTypelInvisible) 
"create new object 
Set objControl = objDoc.HMIObjects.AddActiveXControl("Controlli", 
"CCAxUserArchiveControl.AxUserArchiveControl.1") 
If objControl Is Nothing Then 
GoTo errorhandler 
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See also 


End If 
"doing something with the control 


"delete reference to new control 
Set objControl = Nothing 
"saving PDL and deleting reference to it 
objDoc.Save 
objDoc.Close 
Set objDoc = Nothing 
Exit Sub 
" errorhandler 
errorhandler: 

If MsgBox("Error occurred" & vbNewLine & "Yes resume next" & 
vbNewLine & "No - stop script", vbOKCancel + vbCritical, strFct) = 
vbOK Then 
Resume Next 
End If 
End Sub 


Parent Property (Page 2359) 
Item Property (Page 2283) 
Count Property (Page 2201) 
Application Property (Page 2121) 


How to edit Default objects, Smart objects, Windows objects and Tube objects 


Introduction 
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Here you will find the following instructions for editing Standard, Smart and Windows objects: 
e Define properties of a specific object 

e@ Define properties of a nonspecific object 

@ Select an object in the active picture 

e@ Find objects in the active picture 


@ Delete object 
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Procedure 


1. Open the VBA editor in Graphics Designer (<ALT+F11> or "Tools" > "Macros" > "Visual 
Basic Editor") 


2. Open the document "ThisDocument" in the Project Explorer: 


Project - ¥BAProject3 x 
a : 
+ 


GlobalTemplate (C:\Siemens\,WinCC\! 
as ProjectTemplate (C:\ Siemens‘, WinCC' 
as ¥BAProject3 (C:\ Siemens’, WinCC', Win 
=| Graphics Designer Objects 
ThisDocument (dynamic_test.PDL} 


+ 


+]-(9 References 


3. To define the properties of a specific object type (e.g. "HMICircle"), you can for example 
insert an "EditDefinedObjectType()" procedure in the document "ThisDocument". In this 
example a circle is inserted in the active picture and its line weight and color are modified: 


Sub EditDefinedObjectType () 

"VBA33 

Dim objCircle As HMICircle 

Set objCircle = 
ActiveDocument.HMIObjects.AddHMIObject ("myCircleAsCircle", 
"HMTCircle") 

With objCircle 

"direct calling of objectproperties available 
-BorderWidth = 4 

-BorderColor = RGB(255, 0, 255) 

End With 

End Sub 


4. Tochange the properties of a nonspecific object type ("HMIObject"), insert a 
"EditHMlObject()" procedure in the document "ThisDocument", for example. In this example 
a circle is inserted in the active picture and its line weight and color are modified: 
Sub EditHMIObject () 

'VBA34 

Dim objObject As HMIObject 

Set objObject = 

ActiveDocument.HMIObjects.AddHMIObject ("myCircleAsObject", 
"HMTCircle") 

With objObject 

"Access to objectproperties only with property "Properties": 


.Properties("BorderWidth") = 4 

.Properties ("BorderColor") = RGB(255, 0, 0) 
End With 

End Sub 
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5. To select an object in the current picture, insert a "SelectObject()" procedure in the 
document "ThisDocument", for example. In this example, a circle will be inserted in the 
active picture and selected: 

Sub SelectObject () 

"VBA35 

Dim objObject As HMIObject 

Set objObject = 

ActiveDocument.HMIObjJects.AddHMIObject ("mySelectedCircle", 
"HMTCircle") 

ActiveDocument.HMIObjects ("mySelectedCircle") .Selected = Tru 

End Sub 


WinCC: Scripting (VBS, ANSI-C, VBA) 
1666 System Manual, 02/2016, A5E37536061-AA 


VBA for Automated Configuration 


3.3 VBA in the Graphics Designer 


6. To search for an object in the current picture, insert a "FindObjectsByName()", 


"FindObjectsByType()," or "FindObjectsByProperty()" procedure in the document 
"ThisDocument", for example. In this example, objects containing the string "Circle" in their 
name are searched for: 

Sub FindObjectsByName () 

"VBA36 

Dim colSearchResults As HMICollection 

objMember As HMIObject 

iResult As Integer 

strName As String 


(? 


2, *) 


"Wildcards are allowed 
Set colSearchResults 
ActiveDocument.HMIObjects.Find(ObjectName:="*Circle*") 


For Each objMember In colSearchResults 


iResult = colSearchResults.Count 

strName = objMember.ObjectNam 

MsgBox "Found: " & CStr(iResult) & vbCrLf & "Objectname: " & 
strName 

Next objMember 

End Sub 


In this example a search is run in the active picture for objects of the type "HM|ICircle": 
Sub FindObjectsByType () 
"VBA37 


Dim 


colSearchRes 
objMember As 


ults As HMICollection 
HMTObject 


iResult As Integer 


strName As §S 
colSearchRes 


tring 
ults 


tiveDocument.HMIObjects.Find(ObjectType:="HMICircle") 
cr Each objMember In colSearchResults 

ult = colSearchResults.Count 
= objMember.ObjectNam 

" & CStr(iResult) 


Ss 
strNam 
MsgBox "Found: 
strName 

Next objMember 
End Sub 

In this example a search is run in the active picture for objects with the property "BackColor": 
Sub FindObjectsByProperty () 

"VBA38 

Dim colSearchRes 
objMember As 
iResult As Integer 
strName As String 
colSearchResults 
tiveDocument.HMIObjects.Find(PropertyName:="BackColor") 
Each objMember In colSearchResults 

ult = colSearchResults.Count 
= objMember.ObjectNam 
""& CStr(iResult) 


"W 


& vbCrLf & "Objektname: & 


ults As HMICollection 
Dim HMTObject 
Dim 
Dim t 
Se 
Ac 
Fo 
iRes 
strNam 
MsgBox "Found: 
strName 


Next objMember 


" 


& vbCrLf & "Objectname: & 
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End Sub 


7. To delete an object, you can for example insert a "DeleteObject()" procedure in the 
document "ThisDocument". In this example the first object in the active picture will be 
deleted. 

Sub DeleteObject () 
"VBA39 
"Delete first object in active document: 
ActiveDocument.HMIObjects(1).Delete 
End Sub 


8. Start the procedure with <F5>. 


See also 
Find Method (Page 1841) 
Delete Method (Page 1831) 
AddHMlObject Method (Page 1801) 
How to edit Default objects, Smart objects, Windows objects and Tube objects (Page 1664) 
Editing Objects with VBA (Page 1660) 
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OLE Objects 


Introduction 


You can use VBA to insert OLE Elements into a picture. The OLE Element belongs to the 
Smart objects. In the Graphics Designer, the object is available in the "Default" selection 
window: 


| <x 
4)-e Standard Objects 
&)~-4} Smart Objects 
4 Application Window 
{7} Picture Window 
-0Ck} Control 
OLE) OLE Element 
l/O Field 
fE Bar 
-24| Graphic Object 
‘33 Status Display 
‘0% Text List 
AB Multiple row text 
3 Combobox 
25 List box 
AE} Faceplate instance 
zie, ‘NET Control 
ogc) WPF Control 
J 3D-Bar 
4) Group Display 
4 Windows Objects 
f)~ Tube objects 


fF 


\a Standard nla Controls | == Styles 
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Paste OLE Element in Picture 


Sub Addo 
"VBA40 


Use the "AddOLEControl(ObjectName, ServerName, [CreationType], [UseSymbol]) method 
to insert an OLE Element into a picture. ObjectName" stands for the object name, and 
"ServerName" for the application that is to be contained in the OLE Element. The 
"ServerName" parameter corresponds to the object type in the "object insertion dialog. The 
last two parameters are optional and represent the possible settings" in the dialog displayed: 


Insertar objeto es] 

Tipo de objeto: Aceptar 

@ Crear nuevo Adobe Acrobat Document —————___—_—_—_—_—_—— 
CcCiss Class Cancelar 

; , ControlHost.Document 

ae naar ent ae Documento de Wordpad } 
Imagen de Paintbrush 
"ServerName" Paquete 


|] Mostrar como icono 


Resultado 


Inserta un nuevo objeto Documento de Wordpad 
en su documento. 


You will find further information on the parameters in this documentation under "AddOLEObject 


method". 


In the following example an OLE Element containing a Wordpad document will be inserted 


into the active picture: 


EObJectToActiveDocument () 


Dim objO 


Set objOL! 


EObJect As HMIOLEObJject 


End Sub 


See also 
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BFObject = ActiveDocument.HMIObjects.AddOLI 


"Wordpad. 


Document.1") 


BFObjJect ("MS Wordpad Document1", 


The OLEObject object is added to the "HMlObjects" listing as the last element and inherits the 
properties of the HMlObject object. 


OLEObject Object (Page 2023) 
AddOLE Object Method (Page 1803) 


How to edit Default objects, Smart objects, Windows objects and Tube objects (Page 1664) 


Default objects, Smart objects, Windows objects and Tube objects (Page 1662) 
Editing Objects with VBA (Page 1660) 
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ActiveX controls 


Introduction 


You can use VBA to insert ActiveX controls into a picture. In the Graphics Designer, you can 
find the ActiveX controls supplied with WinCC in the "Controls" selection window: 


Controls vax 
h Selection 


& WinCC Digital/Analog Clock Control 

© WinCC Gauge Control 

3) WinCC Push Button Control 

3) WinCC Slider Control 

{5 wincc AlarmControl 

WinCC OnlineTrendControl 

AN WinCC FunctionTrendControl 

{J WinCC OnlineTableControl 

‘ii WinCC UserArchiveControl 

Es WinCC RulerControl 

fii WinCC Media Control 

cS Siemens HMI Symbol Library 1.4.1 
ne} ‘NET controls 
wet WPF Controls 


AQ standard |Z) controls [SE styles | 


Further information is provided under "AddActiveXControl method" in this documentation and 
under "Working with controls" in the WinCC documentation. 


Integrating standard ActiveX controls 


As well as the ActiveX controls supplied with WinCC, you can insert all standard ActiveX 
controls registered in the operating system into a picture. This means that you also have the 
option of using ActiveX controls that you have programmed yourself in your pictures. A list of 
the standard ActiveX controls tested with WinCC is given in the WinCC documentation. 
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Inserting an ActiveX control into a picture 


Use the "AddActivexControl(ObjectName, ProgID)" method to insert a new ActiveX control 
into a picture. ObjectName" stands for the name of the ActiveX control (e.g. "WinCC Gauge"), 
and "ProgID" for the VBA object designation (e.g. "XGauge.XGauge. 1"): 


Sub AddActiveXControl () 

"VBA41 

Dim objActiveXControl As HMIActiveXControl 

Set objActiveXControl = ActiveDocument.HMIObjects.AddActivexXControl ("WinCC_ Gauge", 
"XGAUGE. XGaugeCtr1l.1") 

End Sub 


The ActiveXControl object is added to the "HMlObjects" listing as the last element and inherits 
the properties of the HMlObject object. 


Access to the properties of the ActiveX control 


You must address the object-specific properties of the ActiveX control via the 
"Properties(Index)" property. You can find out which properties a ActiveX control possesses 
from the "Object Properties" dialog in the Graphics Designer or from the Properties listing: 


Sub AddActiveXControl () 
"VBA42 
Dim objActiveXControl As HMIActiveXControl 


Set objActiveXControl = ActiveDocument.HMIObjects.AddActiveXControl ("WinCC_Gauge2", 
"XGAUGE.XGaugeCtr1l.1") 


‘move ActiveX-control: 
objActivexXControl.Top = 40 
objActiveXControl.Left = 60 
' 
"Change individual property: 

objActiveXControl.Properties ("BackColor") .value = RGB(255, 0, 0) 
End Sub 


Restricted access to background graphics of Controls 


The background graphic cannot be configured in VBA for the following Controls: 


Control Attribute 

WinCC Digital/Analog Clock Control Background graphic 

WinCC Gauge Control Background picture 
Frame picture 

WinCC Push Button Control PictureSelected 
PictureUnselected 

WinCC slider control Background picture 
Slider picture 
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See also 
ActiveXControl Object (Page 1900) 
AddActiveXControl Method (Page 1795) 
How to edit Default objects, Smart objects, Windows objects and Tube objects (Page 1664) 
Default objects, Smart objects, Windows objects and Tube objects (Page 1662) 
Editing Objects with VBA (Page 1660) 
.Net controls 
Introduction 


You can use VBA to insert .Net controls into a picture. In the Graphics Designer, you can find 
the .Net controls in the "Controls" selection window. 


Additional information is provided under "AddDotNetControl method" in this documentation 
and under "Creating process pictures > Working with controls > .Net controls" in the WinCC 
documentation. 


Inserting a .Net control into a picture 


Use the "AddDotNetControl(ObjectName, ControlType, InGAC, Assemblylnfo)" method to 
insert a new .Net control into a picture. "ObjectName" represents the name of the .Net control. 
"ControlType" shows the name space of the object. If "INGAC" is "TRUE", the object is 
registered in the Global Assembly Cache and the associated information is available in 
"AssemblylInfo". 


Sub AddDotNetControl () 

'VBA851 

Dim DotNetControl As HMIDotNetControl 

Set DotNetControl = ActiveDocument.HMIObjects.AddDotNetControl ("MyVBAControl", 
"System.Windows.Forms.Label", True,"Assembly=System.Windows.Forms, Version=2.0.0.0, 
Culture=neutral, PublicKeyToken=b77a5c561934e089") 

End Sub 


The .Net control object is added to the "HMIObjects" listing as an element and inherits the 
properties of the HMlObject object. 


Access to the properties of the .Net control 


You can find out which properties a .Net control has from the "Object Properties > Control 
Properties" dialog in Graphics Designer. 
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WPF controls 


Introduction 


You can use VBA to insert WPF controls into a picture. In the Graphics Designer, you can find 
the WPF controls in the "Controls" selection window. 


Additional information is provided under "AddWPFControl method" in this documentation and 
under "Creating process pictures > Working with controls > WPF controls" in the WinCC 
documentation. 


Inserting a WPF control into a picture 


Use the "AddWPFControl(ObjectName, ControlType, InGAC, AssemblyInfo)" method to insert 
a new WPF control into a picture. "ObjectName" represents the name of the .Net control. 
"ControlType" shows the name space of the object. If "InNGAC" is "TRUE", the object is 
registered in the Global Assembly Cache and the associated information is available in 
"Assemblylnfo". 


Sub AddWPFControl () 

"VBA852 

Dim WPFControl As HMIWPFControl 

Set WPFControl = ActiveDocument.HMIObjects.AddWPFControl ("MyWPFVBAControl", 
"WinCCWPFControl.TestControl", False, "Assembly=Z:\TestControl\WinCCWPFControl.dll") 
End Sub 


The ActiveXControl object is added to the "HMIlObjects" listing as an element and inherits the 
properties of the HMlObject object. 


Access to the properties of the WPF control 


You can find out which properties a WPF control has from the "Object Properties > Control 
Properties" dialog in Graphics Designer. 


3.3.4.3 Group Objects 


Group Objects 


Introduction 


With VBA you can create a group object from selected objects in the Graphics Designer. You 
can add objects to the group object, or remove objects, without having to ungroup the group 
object itself. You have unrestricted access to the object properties of the individual objects in 
the group object. You can also ungroup a group object again, or delete it entirely. 
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The following object types cannot be part of a group object: 
e CustomizedObject (Customized object) 

e ActiveXControl 

e OLEObject 


Further information regarding group objects can be found in the WinCC documentation under 
"Group Object". 


Creating a group object 


To create a group object, select the objects that you want to be part of the group object in the 
Graphics Designer. The selected objects are then contained in the "Selection" listing. You 
create the group with the "CreateGroup()" method: 


Sub CreateGroup () 

'VBA43 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 
Dim objGroup As HMIGroup 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "“HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SsRectangle", "HMIRectangle") 
With objCircle 

-Top = 40 

-Left = 40 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 80 

-Selected = Tru 

End With 


sgBox "Objects selected!" 

Set objGroup = ActiveDocument.Selection.CreateGroup 
objGroup.ObjectName = "myGroup" 

End Sub 


The group object is inserted at the end of the "HMIObjects" listing. The objects that are 
contained in the group object retain their index numbers and continue to be available in the 
"HMlObjects" listing. 


The objects in the group object are also included in the "GroupedHMlObjects" listing, although 
the index numbers are reassigned. 


Give the group object a name (objGroup.Name = "My Group") so that you can uniquely identify 
it. If you do not assign a name, the group object is given the default designation for the group 
object (e.g. "Group1"). 


The group object has the same properties as the objects of the "Object" type. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 1675 


VBA for Automated Configuration 
3.3 VBA in the Graphics Designer 


Editing a group object 
You can edit a group object as follows: 
e Methode "Add(Index)": Adds a new object to the group object. 
e Methode "Remove(Index)": Removes a object from the group object. 
e "UnGroup()" method: Ungroups the group object (ungroup). 


e "Delete()" Method: Deletes the group object and the objects that it contains. 


Editing objects in a group object 


Use the "GroupedHMlObjects" listing in order to select an object in the group object. In order 
to access its object property you must access the name of the object property via the 
"Properties" property, for example: 


Sub ModifyPropertyOfObjectInGroup () 

"VBA44 

Dim objGroup As HMIGroup 

Set objGroup = ActiveDocument.HMIObjects ("myGroup") 
objGroup.GroupedHMIObjects (1) .Properties ("BorderColor") = RGB(255, 0, 0) 
End Sub 


See also 
SelectedObjects object (Listing) (Page 2060) 
GroupedObjects Object (Listing) (Page 1983) 
Ungroup Method (Page 1892) 
Remove Method (Page 1871) 
Delete Method (Page 1831) 
Add Method (GroupedObjects Listing) (Page 1791) 
How to Edit Objects in Group Objects Using VBA (Page 1679) 
How to Edit the Group Objects Using VBA (Page 1676) 
Editing Objects with VBA (Page 1660) 
VBA in the Graphics Designer (Page 1621) 


How to Edit the Group Objects Using VBA 


Requirements 


You must have created at least two graphic objects in the Graphics Designer and you must 
have selected them. 
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Procedure 


1. Open the VBA editor in Graphics Designer (<ALT+F11> or "Tools" > "Macros" > "Visual 
Basic Editor"). 


2. Open the document "ThisDocument" in the Project Explorer: 


Project - ¥BAProject3 x 
a : 
+ 


GlobalTemplate (C:\Siemens\,WinCC\! 
as ProjectTemplate (C:\ Siemens‘, WinCC' 
as ¥BAProject3 (C:\Siemens),WinCC), Win 
=| Graphics Designer Objects 
ThisDocument (dynamic_test.PDL} 


+ 


+]-(-9 References 


3. To create a group object from selected objects, you can for example insert a 
"CreateGroup()" procedure in the document "ThisDocument". In this example the group 
object "My Group" is created from a number of objects. 

Sub CreateGroup () 

"VBA45 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 

Dim objGroup As HMIGroup 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", 

"HMTCircle") 

Set objRectangle = 

ActiveDocument.HMIObjects.AddHMIObject ("SRectangle", 

"HMTRectangle") 

With objCircle 

-Top = 40 

-Left = 40 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

.Left = 80 

-Selected = Tru 

End With 

MsgBox "Objects selected!" 

Set objGroup = ActiveDocument.Selection.CreateGroup 

"The name identifies the group-object 

objGroup.ObjectName = "My Group" 

End Sub 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 1677 


VBA for Automated Configuration 


3.3 VBA in the Graphics Designer 


See also 
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4. To add an object to the "My Group" group object, insert a "AddObjectToGroup()" procedure 


in the document "ThisDocument", for example. In this example, an ellipse is added to the 
"My Group" group object: 

Sub AddObjectToGroup () 

"VBA46 

Dim objGroup As HMIGroup 

Dim objEllipseSegment As HMIE1lipseSegment 

"Adds new object to active document 

Set objEllipseSegment = 
ActiveDocument.HMIObjects.AddHMIObject ("EllipseSegment", 
"HMIE1LLipseSegment") 

Set objGroup = ActiveDocument.HMIObjects ("My Group") 
"Adds the object to the group 
objGroup.GroupedHMIObjects.Add ("EllipseSegment") 

End Sub 


5. To remove an object from the "My Group" group object, insert a 
"RemoveObjectFromGroup()" procedure in the document "ThisDocument", for example. In 
this example the first object will be removed from the "My Group" group object: 
Sub RemoveObjectFromGroup () 
"VBA47 
Dim objGroup As HMIGroup 
Set objGroup = ActiveDocument.HMIObjects ("My Group") 
"delete first object of the group-object 
objGroup.GroupedHMIObjects.Remove (1) 

End Sub 


6. To ungroup the "My Group" group object again, insert a procedure "UnGroup()" into the 
document "ThisDocument". In this example, the "My Group" group object is ungrouped: 
Sub UnGroup () 

'VBA48 

Dim objGroup As HMIGroup 

Set objGroup = ActiveDocument.HMIObjects ("My Group") 

objGroup.UnGroup 

End Sub 


7. To delete the "My Group" group object, insert a procedure "DeleteGroup()" into the 
document "ThisDocument". In this example, the "My Group" group object is deleted, 
together with the objects it contains: 

Sub DeleteGroup () 

"VBA49 

Dim objGroup As HMIGroup 

Set objGroup = ActiveDocument.HMIObjects ("My Group") 

objGroup.Delete 

End Sub 


8. Always start the procedure with <F5>. 


Ungroup Method (Page 1892) 
Remove Method (Page 1871) 
Delete Method (Page 1831) 
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CreateGroup Method (Page 1829) 

Add Method (GroupedObjects Listing) (Page 1791) 
SelectedObjects object (Listing) (Page 2060) 

GroupedObjects Object (Listing) (Page 1983) 

Group Object (Page 1978) 

How to Edit Objects in Group Objects Using VBA (Page 1679) 
Group Objects (Page 1674) 

Editing Objects with VBA (Page 1660) 

VBA in the Graphics Designer (Page 1621) 


How to Edit Objects in Group Objects Using VBA 


Introduction 
Here you will find the following instructions for editing objects in a group object with VBA: 
e Editing a property of an object in the group object 
e Editing a property of all objects in the group object 


Requirement 


You must have created at least two graphic objects in the Graphics Designer and you must 
have grouped them. 


Procedure 


1. Open the VBA editor in Graphics Designer (<ALT+F11> or "Tools" > "Macros" > "Visual 
Basic Editor"). 


2. Open the document "ThisDocument" in the Project Explorer: 


Project - ¥BAProject3 x} 
ia : 


GlobalTemplate (C:\Siemens'\,WinCC\! 
as ProjectTemplate (C:\Siemens\,WinCC' 
as ¥BAProject3 (C:\\Siemens\,WinCC', Win 
=| 3 Graphics Designer Objects 


ThisDocument (dynamic 
+]-(9 References 
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To edit a property of an object within the group object, you can for example insert a 


"ChangePropertiesOfGroupMembers()" procedure into the document "ThisDocument". In 
this example the properties of three different objects are modified in the group object "My 


Group": 
Sub Change 
"VBA50 
Dim obj 
obj 
obj 


Rec 
Ellipse As HMIE11 
objGro 
Set objCircle 
"HMTCircle") 
Set objRectangle 
ActiveDoc 
"HMTRectangle") 
t objEllipse 
tiveDocument.HMTObject 
ith objCircle 

. Top 40 

.Left 40 

-Selected = Tru 

End With 

With objRectangle 

. Top 80 

.Left 80 

-Selected = Tru 

End With 

With objEllipse 

. Top 120 

.Left 120 

-Selected = Tru 

End With 

MsgBox 
Set objGroup ActiveDoc 


up As HMIGroup 
ActiveDocumen 


ument.HMIObjects.Add 


Circle As HMICircle 
tangle As HMIRectangle 


ipse 


s.Add 


"Objects selected!" 


ument.Selec 


objGroup.ObjectNam 
"Set bordercolor of 1. 
objGroup.GroupedHMIObjec 
RGB(255, 0, 0) 
"set x-coordinate of 2. 
objGroup.GroupedHMIObjec 
"set x-coordinate of 3. 
objGroup.GroupedHMIObjec 
End Sub 
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e = "My Group" 
object 


ts(1).Prope 


HMTObject ("s 


HMIObject ("SEllipse", 


PropertiesOfGroupMembers () 


t.HMIObjects.AddHMIObject ("SCircle", 


Rectangle", 


"HMIE11lipse") 


tion.CreateGroup 


"red": 


rties ("BorderColor") 


object = "120" 

ts(2).Properties ("Left") = 120 
object = "90" : 
ts(3).Properties ("Top") = 90 
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4. To change the properties of all the objects in the group object, insert a 
"ChangePropertiesOfAllGroupMembers()" procedure in the document In this example, the 
"BorderColor" property of each object in the "My Group" group object is changed. This 
example will not work unless you have created the "My Group" group object: 

Sub ChangePropertiesOfAl1lGroupMembers () 

"VBA51 

Dim objGroup As HMIGroup 

Dim iMaxMembers As Integer 

Dim iIndex As Integer 

Set objGroup = ActiveDocument.HMIObjects ("My Group") 

iIndex = 1 

' 
"Get number of objects in group-object: 
iMaxMembers = objGroup.GroupedHMIObjects.Count 


"set linecolor of all objects = "yellow": 

For iIndex = 1 To iMaxMembers 
objGroup.GroupedHMIObjects (iIndex) .Properties("BorderColor") = 
RGB(255, 255, 0) 

Next iIndex 

End Sub 


5. Always start the procedure with <F5>. 


See also 
Properties Object (Listing) (Page 2041) 
GroupedObjects Object (Listing) (Page 1983) 
Ungroup Method (Page 1892) 
Remove Method (Page 1871) 
Delete Method (Page 1831) 
Add Method (GroupedObjects Listing) (Page 1791) 
How to Edit the Group Objects Using VBA (Page 1676) 
Group Objects (Page 1674) 
Editing Objects with VBA (Page 1660) 
VBA in the Graphics Designer (Page 1621) 
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3.3.4.4 Customized Objects 


Customized Objects 


Introduction 


You can use VBA to create a customized object from selected objects in the Graphics Designer. 
In contrast to the group object, in the case of a customized object only those object properties 
are available which you have selected in the "Configuration Dialog" for the customized object. 
It is not possible to configure a customized object with VBA. 


Further information regarding customized objects can be found in the WinCC documentation 
under "Customized Object". 


Creating a customized object with VBA 


Use the "CreateCustomizedObject()" method to create a customized object from selected 
objects: 


Sub CreateCustomizedObject () 

"VBA52 

Dim objCustomizedObject As HMICustomizedObject 

Set objCustomizedObject = ActiveDocument.Selection.CreateCustomizedObject 
objCustomizedObject.ObjectName = "My Customized Object" 

End Sub 


When you apply the "CreateCustomizedObject()" method, the "Configuration Dialog" appears 
in which you select the object properties. The customized object that you have created is added 
to the "HMIObjects" listing. Give the customized object an appropriate name 

(objCustomizedObject.Name = "My Customized Object") so that you can uniquely identify it. 


Note 


If you open a document as invisible, do not create a user object there with a VBA script. 
Program execution will otherwise be interrupted by a configuration dialog. 


Editing Customized Objects 
You can edit a customized object as follows: 
¢ "Destroy" method: Ungroups the customized object. 


e "Delete" Method: Deletes the customized object and the objects that it contains. 
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Editing objects in a customized object 


Use the "Properties" property to access the selected object properties of the objects contained 
in the customized object. 


Sub EditCustomizedObjectProperty () 


"VBA53 


End Sub 


See also 


Dim objCustomizedObject As HMICustomizedObject 
Set objCustomizedObject = ActiveDocument.HMIObjects (1) 


objCustomizedObject. Properties ("BackColor") = RGB(255, 0, 0) 


If you have selected more than one identical property (for example the background color of a 
circle and of a rectangle), these properties will be numbered ("BackColor" and "BackColor1"). 


HMIObject Object (Page 1988) 

CustomizedObject Object (Page 1938) 

Destroy Method (Page 1835) 

Delete Method (Page 1831) 

CreateCustomizedObject Method (Page 1825) 

How to Edit a Customized Object with VBA (Page 1683) 
How to Edit the Group Objects Using VBA (Page 1676) 
Group Objects (Page 1674) 

Editing Objects with VBA (Page 1660) 


How to Edit a Customized Object with VBA 


Introduction 


Here you will find the following instructions for editing a customized object with VBA: 
@ Creating a customized object from selected objects 
e@ Ungrouping Customized Objects 


e Deleting a customized object 


Note 


It is not possible to configure a customized object with VBA. 
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Procedure 


1. Open the VBA editor in Graphics Designer (<ALT+F11> or "Tools" > "Macros" > "Visual 
Basic Editor"). 


2. Open the document "ThisDocument" in the Project Explorer: 
x 

ia é 

+ 


GlobalTemplate (C:\\Siemens',WinCC\! 
a ProjectTemplate (C:\Siemens'\,WinCC' 
a ¥BAProject3 (C:\\Siemens',WinCC', Win 
=| Graphics Designer Objects 

ThisDocument (dynamic_test.PDL) 
(9 References 


+ 


3. To create a customized object from selected objects, you can for example insert a 
"CreateCustomizedObject()" procedure in the document "ThisDocument". In this example 
the customized object "My Customized Object" is created from selected objects: 

Sub CreateCustomizedObject () 

"'VBA54 

Dim objCustomizedObject As HMICustomizedObject 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", 

"HMTICircle") 

Set objRectangle = 

ActiveDocument.HMIObjects.AddHMIObject ("SRectangle", 


"HMTRectangle") 
With objCircle 
-Top = 40 

-Left = 40 
-Selected = Tru 
End With 

With objRectangle 
-Top = 80 

.Left = 80 
-Selected = Tru 
End With 


MsgBox "Objects selected!" 
Set objCustomizedObject = 


ActiveDocument.Selection.CreateCustomizedObject 
' 


'xx* The "Configurationdialog" started. *** 


'x** Configure the costumize-object with the "configurationdialog" 
KK*K 


objCustomizedObject.ObjectName = "My Customized Object" 
End Sub 
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4. To delete an object, you can for example insert a "DeleteObject()" procedure in the 
document "ThisDocument". In this example the customized object "My Customized Object" 
created beforehand is deleted again: 

Sub DestroyCustomizedObject () 
"VBA55 
Dim objCustomizedObject As HMICustomizedObject 
Set objCustomizedObject = ActiveDocument.HMIObjects ("My 
Customized Object") 
objCustomizedObject.Destroy 
End Sub 


5. To delete a customized object, you can for example insert a "DeleteCustomizedObject()" 
procedure in the document "ThisDocument". In this example the customized object "My 
Customized Object" created beforehand is deleted: 

Sub DeleteCustomizedObject () 
"VBA56 
Dim objCustomizedObject As HMICustomizedObject 
Set objCustomizedObject = ActiveDocument.HMIObjects ("My 
Customized Object") 
objCustomizedObject.Delet 
End Sub 


6. Always start the procedure with <F5>. 


See also 
Destroy Method (Page 1835) 
Delete Method (Page 1831) 
CreateCustomizedObject Method (Page 1825) 
Customized Objects (Page 1682) 
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3.3.5 Creating Dynamics with VBA 
3.3.5.1 Creating Dynamics with VBA 
Introduction 


VBA allows you to add dynamics to properties of pictures and objects and to configure event- 
controlled actions. VBA provides you with the ActionDynamic object for this purpose: 


Legend: 
[ ] Object and Collection 


[ ] Object 


Transfer: Object 
depends on type 


The ActionDynamic object represents an interface that is dependent on the object type: 


e@ When you configure a dynamic for a property (Property object), the ActionDynamic object 
inherits the properties of the ScriptInfo, Trigger and DynamicDialog objects. 


e@ When you configure an event-controlled action (Event object), the ActionDynamic object 
inherits the properties of the ScriptInfo and DirectConnection objects. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
1686 System Manual, 02/2016, A5E37536061-AA 


VBA for Automated Configuration 
3.3 VBA in the Graphics Designer 


Adding dynamics to properties of pictures and objects 


VBA enables you to add dynamics to properties of pictures and objects. You can use tags, 
scripts or the Dynamic dialog to add dynamics. Using dynamics enables you for example to 
configure a color change for an object in runtime when the value of a variable changes. 


Configuring event-controlled actions 


You can configure event-controlled actions with VBA. An action (script or direct connection) is 
triggered then the defined event occurs in runtime. An event may be a change to an object 
property, for example, or the clicking of a button. 


Editing Triggers 


You can edit triggers with VBA. Triggers are required when you use dynamics. They determine 
when a dynamic value is updated in runtime. This may occur at regular intervals, for example, 
or in the event of a picture change. 


When you configure event-controlled actions, the event is the trigger. 


See also 
Editing Triggers (Page 1707) 
Configuring Event-Driven Actions with VBA (Page 1699) 
Configuring Dynamics in the Properties of Pictures and Objects (Page 1687) 


3.3.5.2 Configuring Dynamics in the Properties of Pictures and Objects 


Configuring Dynamics in the Properties of Pictures and Objects 


Introduction 


VBA enables you to add dynamics to properties of pictures and objects. Dynamic object 
properties can be changed as a function of a variable value in Runtime, for example. The 
following methods of adding dynamics are possible: 


@ Tag connection 
e Dynamic dialog 


e Scripts 
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Principle 


The following example illustrates the principle of the procedure for adding dynamics to an 
object property: 


Sub CreateDynamicOnProperty () 


"VBA57 


Dim objVariableTrigger As HMIVariableTrigger 
Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circlel", "“HMICircle") 
r 


"Create dynamic with type "direct Variableconnection" at the 
"property "Radius": 
Set objVariableTrigger = 


objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeVariableDirect, "'NewDynamicl'") 


'To complete dynamic, e.g. define cycle: 
With objVariableTrigger 
.CycleType = hmiVariableCycleType 2s 


End With 
End Sub 


Tag connection 


Dynamic dialog 


1688 


Note 


Note that a variable is not created simply by specifying the variable name. Use the variable 
selection dialog to create the variable. 


Use the VariableTrigger object to add a dynamic to a property with a direct or indirect variable 
connection. The dynamic property then responds in runtime to a change in value to the 
specified variable. To allow this, in VBA you need to specify the variable name (VarName 
property) and the cycle (CycleTime property). 


Use the DynamicDialog object to add a dynamic to a property with the aid of the Dynamic 
dialog. The dynamic property responds in runtime to a variable's value ranges. The following 
objects are available for specifying the value range: 


e AnalogResultInfos-Objekt: Use this object to assign a fixed value to value ranges of a 
variable or a script. The fixed value is assigned to the dynamic property when the variable 
value or return value of the script is within the specified value range. 


e@ BinaryResultlnfo Object: Use this object to assign a fixed value to binary value ranges (zero 
and non-zero) of a variable or a script. The fixed value is assigned to the dynamic property 
when the variable value or return value of the script returns one of the two values. 


e VariableStateValue Object Use this object to assign a fixed value to the state (e.g. "Upper 
limit exceeded") of a specified variable. The fixed value is then allocated to the dynamic 
property when the state occurs. 
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Scripts 
Use the Scriptlnfo object to add a dynamic to a property with a C or VB script. The property 
with the dynamic reacts to a script in Runtime and is controlled via a trigger. Use the Trigger 
object for configuring the trigger. 

See also 


VariableTrigger Object (Page 2099) 

VariableStateValue Object (Page 2096) 

Trigger Object (Page 2087) 

Scriptinfo Object (Page 2058) 

BinaryResultInfo Object (Page 1918) 

AnalogResultInfos Object (Listing) (Page 1908) 

How to dynamize a property with a VB script (Page 1697) 

How to dynamize a property with a C script (Page 1694) 

How to dynamize a property with the Dynamic dialog (Page 1691) 
How to dynamize a property with a tag connection (Page 1689) 
Creating Dynamics with VBA (Page 1686) 


How to dynamize a property with a tag connection 


Introduction 
Here you will find the following instructions for dynamizing a property with tag connection: 
e Dynamizing a property with direct tag connection 


e Dynamizing a property with indirect tag connection 
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Procedure 


1. Open the VBA editor in Graphics Designer (<ALT+F11> or "Tools" > "Macros" > "Visual 
Basic Editor") 


2. In Project Explorer, open the document in which you want to write the VBA code: 


Project - ProjectTemplate x} 
‘a : 


GlobalTemplate (C:\\Siemens', WinCC\ bin',@GLC 
@9 Graphics Designer Objects 
GlobalTemplateDocument (@GLOBAL.PDT} 
ss ProjectTemplate (C:\\Siemens'\,WinCC\, WinCCPr 
=| Graphics Designer Objects 
ProjectTemplateDocument (@PROJECT.PDT) 
+) (99 References 
ae ¥BAProject3 (C:\ Siemens), WinCC), WinCCProjec 
3 Graphics Designer Objects 
ThisDocument (dynamic_test.PDL) 
(9 References 


fa) 


3. To dynamize an object property with a direct tag connection, you can for example insert an 
"AddDynamicAsVariableDirectToProperty()" procedure in the document. "In this example 
a circle property "Top" will be made dynamic with the aid of the tag Otto: 

Sub AddDynamicAsVariableDirectToProperty() 

"VBA58 

Dim objVariableTrigger As HMIVariableTrigger 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circlel", 
"HMICircle") 

"Create dynamic at property "Top" 

Set objVariableTrigger = 

objCircle.Top.CreateDynamic (hmiDynamicCreationTypeVariableDirect, 
"Otto") 


"define cycle-tim 

With objVariableTrigger 

.CycleType = hmiVariableCycleType 2s 
End With 

End Sub 
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4. To dynamize an object property with an indirect tag connection, you can for example insert 
an "AddDynamicAsVariablelnDirectToProperty"() procedure in the document. "In this 
example a circle property Left" will be made dynamic with the aid of the tag "Anton": 

Sub AddDynamicAsVariableIndirectToProperty () 

"VBA59 

Dim objVariableTrigger As HMIVariableTrigger 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument.HMIObjects.AddHMTObject ("Circle2", 
"HMTCircle") 

"Create dynamic on property "Left": 

Set objVariableTrigger = 

objCircle.Left.CreateDynamic (hmiDynamicCreationTypeVariableIndirec 
t, “Anton") 


"Define cycle-tim 

With objVariableTrigger 

.CycleType = hmiVariableCycleType 2s 
End With 

End Sub 


5. Start the procedure with <F5>. 


See also 
CycleType Property (Page 2209) 
VarName Property (Page 2548) 
VariableTrigger Object (Page 2099) 
CreateDynamic Method (Page 1828) 
How to dynamize a property with a VB script (Page 1697) 
How to dynamize a property with a C script (Page 1694) 
How to dynamize a property with the Dynamic dialog (Page 1691) 
Configuring Dynamics in the Properties of Pictures and Objects (Page 1687) 
Creating Dynamics with VBA (Page 1686) 


How to dynamize a property with the Dynamic dialog 


Introduction 


You can use the Dynamic dialog to dynamize properties of pictures and objects depending on 
certain value ranges or variable states. The following value ranges are available for selection: 


e Analog 
e Binary 
e Bit 


e Direct 
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With VBA you specify the type of value range with the ResultType property. These instructions 
illustrate the addition of dynamics to an object property with analog value ranges. Additional 
information dynamization with the dynamic dialog is provided under "DynamicDialog object" 
in the VBA reference in this documentation. 


1. Open the VBA editor in Graphics Designer (<ALT+F11> or "Tools" > "Macros" > "Visual 
Basic Editor") 


2. In Project Explorer, open the document in which you want to write the VBA code: 
xf 
ia 2 


GlobalTemplate (C:\,Siemens',WinCC'\,bin',@GLC 
=| Graphics Designer Objects 
GlobalTemplateDocument (@GLOBAL.PDT) 
as ProjectTemplate (C:\Siemens', WinCC\, WinCCPr 
=| 9 Graphics Designer Objects 
ProjectTemplateDocument (@PROJECT.PDT) 
(+)-(9 References 
as ¥BAProject3 (C:\Siemens\, WinCC\, WinCCProjec 
=| Graphics Designer Objects 

ThisDocument (dynamic_test.PDL) 
+]-( References 


| 


3. To dynamize an object property with the Dynamic dialog, you can for example insert an 


"AddDynamicDialogToCircleRadiusTypeAnalog()" procedure in the document. In the 
following example the radius of a circle will be dynamically configured using the Dynamic 
dialog, a tag name will be assigned and three analog value ranges will be created: 


4. Start the procedure with <F5>. 
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Sub AddDynamicDialogToCircleRadius TypeAnalog() 

'VBA60 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument.HMlObjects.AddHMlObject("Circle_A", "HMICircle") 
‘Create dynamic 

Set objDynDialog = objCircle.Radius.CreateDynamic(hmiDynamicCreationTypeDynamicDialog, '"NewDynamic1") 
‘Configure dynamic. "ResultType" defines the type of valuerange: 

With objDynDialog 

.ResultType = hmiResultTypeAnalog 

-AnalogResultInfos.Add 50, 40 

-AnalogResultInfos.Add 100, 80 

.AnalogResultInfos.ElseCase = 100 

End With 

End Sub 


New VBA method to configure dynamization using the Dynamic Dialog 
For optimization reasons, an additional new method has been provided: 
@ CreateDynamicDialog([Code as String], iResultType as Long) as HMIActionDynamic 
The parameter "IResultType" has the following constants: 
e hmiResultTypeDirect = 0 
e hmiResultTypeAnalog= 1 
e hmiResultTypeBool = 2 
e hmiResultTypeBit = 3 


In the following example the radius of a circle is given dynamics with the A tag name and a 
"ResultType" are assigned to the dynamic dialog. 


Sub AddDynamicDialogToCircleRadiusTypeAnalog() 

'VBA820 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 

‘Create Object 

Set objCircle = ActiveDocument.HMlObjects.AddHMIlObject("myCircle","HMICircle") 
‘Create dynamic (Tag "myTest" must exist") 

Set objDynDialog = objCircle.Radius.CreateDynamicDialog( 
End Sub 


myTest' 0) 
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Initializing a string property 


A string property must be initialized before being made dynamic by assigning a text to it. In 
the following ToolTipText example, this is done in "objCircle.ToolTipText = "Text". 


Sub Dyn() 

'VBA823 

Dim objCircle As HMICircle 

Dim doc As Document 

Dim objDynDialog As HMIDynamicDialog 

Set doc = ActiveDocument 

Set objCircle = ActiveDocument.HMlObjects.AddHMIObject("Circle","HM|ICircle") 
objCircle.ObjectName = "Circle1" 

objCircle.BorderColor = RGB(255, 0, 0) 

objCircle.BackColor = RGB(0, 255, 0) 

objCircle.ToolTipText = "Text" 

Set objDynDialog = objCircle. ToolTipText. CreateDynamic(hmiDynamicCreationT ypeDynamicDialog, "Var") 
End Sub 


See also 
How to dynamize a property with a tag connection (Page 1689) 
ResultType Property (Page 2399) 
DynamicDialog Object (Page 1955) 
CreateDynamic Method (Page 1828) 
How to dynamize a property with a VB script (Page 1697) 
How to dynamize a property with a C script (Page 1694) 
Configuring Dynamics in the Properties of Pictures and Objects (Page 1687) 
Creating Dynamics with VBA (Page 1686) 
ToolTipText Property (Page 2445) 


How to dynamize a property with a C script 


Introduction 


When you dynamize a property with a C script, you can assign the C code to the "SourceCode" 
property. The C script is compiled in the background. The "Compiled" property returns "True" 
when the C code has been successfully compiled. 
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Procedure 


1. Open the VBA editor in Graphics Designer (<ALT+F11> or "Tools" > "Macros" > "Visual 
Basic Editor") 


2. In Project Explorer, open the document in which you want to write the VBA code: 


xf 
i] : 
= GlobalTemplate (C:\Siemens', WinCC\ bin',@GLC 
=| 9 Graphics Designer Objects 
GlobalTemplateDocument (@GLOBAL.PDT} 
as ProjectTemplate (C:\ Siemens‘, WinCC',WinCCPr 
=) 9 Graphics Designer Objects 
ProjectTemplateDocument (@PROJECT.PDT} 

+]--(9 References 
as ¥BAProject3 (C:\ Siemens), WinCC', WinCCProjec 
=| 9 Graphics Designer Objects 

BZ ThisDocument (dynamic_test.PDL) 
(9 References 


pa) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 1695 


VBA for Automated Configuration 


3.3 VBA in the Graphics Designer 


See also 


1696 


3. To add dynamics to an object property with a C script, you can for example insert an 
"AddDynamicAsCScriptToProperty()" procedure in the document. In this example the 
height of a circle is increased by 5 pixels every two seconds in runtime: 

Sub AddDynamicAsCSkriptToProperty () 
'VBA61 

Dim objCScript As HMIScriptiInfo 
Dim objCircle As HMICircle 

Dim strCode As String 


strCode = "long lHeight;" & vbCrLf & "int check;" & vbCrLf 
strCode = strCode & "GetHeight (""events.PDL"™",""myCircle"™");" & 
vbCrLf 

strCode = strCode & "lHeight = lHeight+5;" & vbCrLf 

strCode = strCode & "check = SetHeight(""events.PDL"", 
""myCircle™", lHeight );" 

strCode = strCode & vbCrLf & "//Return-Type: BOOL" & vbCrLf 
strCode = strCode & "return check;" 


Set objCircle = 
ActiveDocument.HMIObjects.AddHMIObject ("myCircle", "HMICircle") 
"Create dynamic for Property "Height": 

Set objCScript = 

objCircle.Height.CreateDynamic (hmiDynamicCreationTypeCScript) 


"set Sourcecode and cycletime: 

With objCScript 

-SourceCode = strCode 

.Trigger.Type = hmiTriggerTypeStandardCycle 
.Trigger.CycleType = hmiCycleType 2s 
.Trigger.Name = "Trigger1i" 

End With 

End Sub 


4. Start the procedure with <F5>. 


Trigger Property (Page 2449) 

ScriptType Property (Page 2407) 

SourceCode Property (Page 2424) 

CycleType Property (Page 2209) 

Scriptinfo Object (Page 2058) 

CreateDynamic Method (Page 1828) 

How to dynamize a property with a VB script (Page 1697) 

How to dynamize a property with the Dynamic dialog (Page 1691) 
How to dynamize a property with a tag connection (Page 1689) 
Configuring Dynamics in the Properties of Pictures and Objects (Page 1687) 
Creating Dynamics with VBA (Page 1686) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


VBA for Automated Configuration 
3.3 VBA in the Graphics Designer 


How to dynamize a property with a VB script 


Introduction 
When you dynamize a property with a VB script, you can assign the VB code to the 
"SourceCode" property. The VB script is compiled in the background. The "Compiled" property 
returns "True" if the VB code is syntactically correct. 

Procedure 


1. Open the VBA editor in Graphics Designer (<ALT+F11> or "Tools" > "Macros" > "Visual 
Basic Editor") 


2. In Project Explorer, open the document in which you want to write the VBA code: 


Project - ProjectTemplate x} 
5 : 


GlobalTemplate (C:\Siemens',WinCC\ bin',@GLC 
=| Graphics Designer Objects 
GlobalTemplateDocument (@GLOBAL.PDT} 
as ProjectTemplate (C:\Siemens', WinCC\, WinCCPr 
=| Graphics Designer Objects 

ProjectTemplateDocument (@PROJECT.PDT) 
(9 References 


Fs 
ae ¥BAProject3 (C:\ Siemens), WinCC), WinCCProjec 
=|-9 Graphics Designer Objects 

ThisDocument (dynamic_test.PDL) 
(9 References 


pa) 
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3. To add dynamics to an object property with a VB script, you can for example insert an 
"AddDynamicAsVBScriptToProperty()" procedure in the document. In this example the 
radius of a circle is increased by 5 pixels every two seconds in Runtime: 

Sub AddDynamicAsVBSkriptToProperty () 

"VBA62 

Dim objVBScript As HMIScriptInfo 

Dim objCircle As HMICircle 

Dim strCode As String 

strCode = "Dim myCircle" & vbCrLf & "Set myCircle = " 

strCode = strCode & 

"HMTRuntime.ActiveScreen.ScreenItems (""myCircle™")" 

strCode = strCode & vbCrLf & "myCircle.Radius = myCircle.Radius + 
5 W 

Set objCircle = 
ActiveDocument.HMIObjects.AddHMIObject ("myCircle", "HMICircle") 


"Create dynamic of property "Radius": 

Set objVBScript = 
objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeVBScript) 
' 

"Set SourceCode and cycletime: 

With objVBScript 

-SourceCode = strCode 

.Trigger.Type = hmiTriggerTypeStandardCycle 
.Trigger.CycleType = hmiCycleType 2s 
-Trigger.Name = "Triggerli" 

End With 

End Sub 


4. Start the procedure with <F5>. 


See also 
How to dynamize a property with a C script (Page 1694) 
Trigger Property (Page 2449) 
SourceCode Property (Page 2424) 
CycleType Property (Page 2209) 
ScriptiInfo Object (Page 2058) 
CreateDynamic Method (Page 1828) 
How to dynamize a property with the Dynamic dialog (Page 1691) 
How to dynamize a property with a tag connection (Page 1689) 
Configuring Dynamics in the Properties of Pictures and Objects (Page 1687) 
Creating Dynamics with VBA (Page 1686) 
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Configuring Event-Driven Actions with VBA 


Introduction 


With VBA you can configure actions for pictures and objects which are triggered when 
predefined events occur. For example, when the mouse is clicked on an object in Runtime a 
C script is called whose return value is used for the dynamics of an object property. The 
following methods of adding dynamics are possible: 


e Direct connection 
e Scripts 


The events that are used for configuring event-controlled actions occur only in Runtime and 
have nothing to do with the VBA event handlers. 


General Procedure 


You use the Events property for configuring event-controlled actions with VBA. The way this 
property is used depends on whether you are configuring an action on an object or picture or 
a property. 


Configuring an action on an object or picture 


An action that you configure on a picture or object is triggered when a predefined event occurs, 
for example when the object is clicked on with the mouse. You configure an action on an object 
with VBA by using the "Events(Index)" property, where "Index" stands for the triggering event: 


Sub AddActionToObjectTypeCScript () 

"VBA63 

Dim objEvent As HMIEvent 

Dim objCScript As HMIScriptInfo 

Dim objCircle As HMICircle 

"Create circle. Click on object executes an C-action 

Set objCircle = ActiveDocument .HMIObjects.AddHMIObject ("Circle AB", "HMICircle") 
Set objEvent = objCircle.Events (1) 

Set objCScript = objEvent.Actions.AddAction (hmiActionCreationTypeCScript) 


"Assign a corresponding custom-function to the property "SourceCode": 
objCScript.SourceCode = ™" 
End Sub 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 1699 


VBA for Automated Configuration 
3.3 VBA in the Graphics Designer 


Configuring an action on a property 


An action that you configure on a property of a picture or object is triggered when the property 
value changes. You configure an action on a property with VBA by using the "Events(1)" 
property, where the index "1" stands for the event "Upon change": 


Sub AddActionToPropertyTypeCScript () 

"VBA64 

Dim objEvent As HMIEvent 

Dim objCScript As HMIScriptInfo 

Dim objCircle As HMICircle 

"Create circle. Changing of the Property 

'"Radius" should be activate C-Aktion: 

Set objCircle = ActiveDocument .HMIObjects.AddHMIObject ("Circle AB", "HMICircle") 
Set objEvent = objCircle.Radius.Events (1) 

Set objCScript = objEvent.Actions.AddAction (hmiActionCreationTypeCScript) 
' 


"Assign a corresponding custom-function to the property "SourceCode": 
objCScript.SourceCode = ™" 
End Sub 


Direct connection 


Use the DirectConnection object to configure a direct connection. 


Scripts 


Use the ScriptInfo object if you want an event to trigger a C or VB action. 


See also 
How to configure a VB action with VBA on an event (Page 1705) 
Events Property (Page 2223) 
ScriptInfo Object (Page 2058) 
Event Object (Page 1966) 
How to configure a C action with VBA on an event (Page 1703) 
How to configure a direct connection with VBA (Page 1701) 
Event Handling (Page 1709) 
Creating Dynamics with VBA (Page 1686) 
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How to configure a direct connection with VBA 


Introduction 
These instructions show you how to configure a direct connection on the basis of two object 
properties. Further information on the configuring of direct connections with VBA is given in 
the VBA reference in this documentation under "AutomationName property" and "ObjectName 
property" 

Procedure 


1. Open the VBA editor in Graphics Designer (<ALT+F11> or "Tools" > "Macros" > "Visual 
Basic Editor") 


2. In Project Explorer, open the document in which you want to write the VBA code: 


Project - ProjectTemplate x} 
5 . 


GlobalTemplate (C:\Siemens',WinCC\ bin',@GLC 
=| Graphics Designer Objects 
GlobalTemplateDocument (@GLOBAL.PDT} 
as ProjectTemplate (C:\Siemens', WinCC\, WinCCPr 
=| 29 Graphics Designer Objects 

ProjectTemplateDocument (@PROJECT.PDT) 
(9 References 
¥BAProject3 (C:\ Siemens), WinCC', WinCCProjec 
& Graphics Designer Objects 

ThisDocument (dynamic_test.PDL) 
+]-(-9 References 


| 
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. To configure a direct connection to an object property, you can for example insert an 


"AddDirectConnectionToObject()" procedure in the document. In the following example the 
X position of "Rectangle_A" is copied to the Y position of "Rectangle_B" in Runtime by 
clicking on the button: 

Sub DirectConnection() 

"VBA65 

Dim objButton As HMIButton 

Dim objRectangleA As HMIRectangle 

Dim objRectangleB As HMIRectangle 

Dim objEvent As HMIEvent 

Dim objDConnection As HMIDirectConnection 


"Create objects: 

Set objRectangleA = 
ActiveDocument.HMIObjects.AddHMIObject ("Rectangle A", 
"HMTRectangle") 
Set objRectangleB = 
ActiveDocument.HMIObjects.AddHMIObject ("Rectangle B", 
"HMTRectangle") 
Set objButton = 


ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMIButton") 
With objRectangleA 

-Top = 100 

.Left = 100 

End With 

With objRectangleB 

-Top = 250 

.Left = 400 

-BackColor = RGB(255, 0O, OQ) 
End With 

With objButton 

-Top = 10 

.Left = 10 

.Text = "SetPosition" 

End With 

' 


"Directconnection is initiated by mouseclick: 

Set objDConnection = 

objButton.Events (1) .Actions.AddAction (hmiActionCreationTypeDirectC 
onnection) 

With objDConnection 

"Sourceobject: Property "Top" of Rectangle A 

-SourceLink.Type = hmiSourceTypeProperty 

-SourceLink.ObjectName = "Rectangle A" 

-SourceLink.AutomationName = "Top" 


"Destinationobject: Property "Left" of Rectangle B 


.DestinationLink.Type = hmiDestTypeProperty 
.DestinationLink.ObjectName = "Rectangle B" 
.DestinationLink.AutomationName = "Left" 
End With 
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End Sub 
4. Start the procedure with <F5>. 


ObjectName Property (Page 2347) 

AutomationName Property (Page 2124) 

SourceLink Object (Page 2065) 

DestLink Object (Page 1945) 

DirectConnection Object (Page 1947) 

Configuring Event-Driven Actions with VBA (Page 1699) 


How to configure a C action with VBA on an event 


Procedure 


1. Open the VBA editor in Graphics Designer (<ALT+F11> or "Tools" > "Macros" > "Visual 
Basic Editor") 


2. In Project Explorer, open the document in which you want to write the VBA code: 


Project - ProjectTemplate x} 
a . 


GlobalTemplate (C:\Siemens',WinCC\ bin',@GLC 
=| 29 Graphics Designer Objects 
GlobalTemplateDocument (@GLOBAL.PDT) 
as ProjectTemplate (C:\Siemens', WinCC\, WinCCPr 
=| Graphics Designer Objects 

ProjectTemplateDocument (@PROJECT.PDT) 
(9 References 
¥BAProject3 (C:\ Siemens), WinCC), WinCCProjec 
&3 Graphics Designer Objects 

ThisDocument (dynamic_test.PDL) 
+]-(99 References 


pL) 
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3. To configure a C action on an event with VBA, you can for example insert a 
"CreateCActionToClickedEvent()" procedure in the document. In this example a button and 
a circle will be inserted in the active picture. In Runtime the height increases every time you 


click the button: 

Sub CreateCActionToClickedEvent () 

"VBA66 

Dim objButton As HMIButton 

objCircle As HMICircle 

objEvent As HMIEvent 

objCScript As HMIScriptinfo 

strCode As String 

strCode = "long lHeight;" & vbCrLf & "int check;" 
strCode = strCode & "lHeight = GetHeight 
""myCircle™");" 


Dim 


Dim 


Dim 
Dim 


"check = " 
strCode = strCode & "SetHeight (""events.PDL"", 
""myCircle™", lHeight) ;" 


Set objCircle = 
ActiveDocument.HMIObjects.AddHMIObject ("myCircle", 
Set objButton = 
ActiveDocument.HMIObjects.AddHMIObject ("myButton", 
With objCircle 


-Top = 100 

.Left = 100 

-BackColor = RGB(255, 0, 0) 
End With 

With objButton 

-Top = 10 

-Left = 10 

.Text = "Increase height" 
End With 


"Configure directconnection: 
Set objCScript = 


strCode = strCode & vbCrLf & "lHeight = lHeight+5;" 


strCode = strCode & vbCrLf & "//Return-Type: Void" 


& vbCrLf 
(""events.PDL"", 


& vbCrLf & 


"HMTCircle") 


"HMTButton") 


objButton.Events (1) .Actions.AddAction (hmiActionCreationTypeCScript 


) 
With objCScript 


"Not Replace "events.PDL" with your picturename 
.SourceCode = strCode 

End With 

End Sub 


4. Start the procedure with <F5>. 


See also 
ScriptInfo Object (Page 2058) 
Events Object (Listing) (Page 1967) 
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Actions Object (Listing) (Page 1898) 
Configuring Event-Driven Actions with VBA (Page 1699) 


How to configure a VB action with VBA on an event 


Procedure 


1. Open the VBA editor in Graphics Designer (<ALT+F11> or "Tools" > "Macros" > "Visual 
Basic Editor") 


2. In Project Explorer, open the document in which you want to write the VBA code: 


Project - ProjectTemplate x 
o : 


GlobalTemplate (C:\\Siemens',WinCC\ bin',@GLC 
=| 29 Graphics Designer Objects 
GlobalTemplateDocument (@GLOBAL.PDT} 
as ProjectTemplate (C:\Siemens', WinCC', WinCCPr 
9 Graphics Designer Objects 

ProjectTemplateDocument (@PROJECT.PDT) 
(9 References 
¥BAProject3 (C:\ Siemens), WinCC', WinCCProjec 
@3 Graphics Designer Objects 

ThisDocument (dynamic_test.PDL) 
(9 References 


i 
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3. To configure an event-oriented VB action with VBA, you can for example insert a 
"CreateVBActionToClickedEvent()" procedure in the document. In this example a button 
and a circle will be inserted in the active picture. In Runtime the radius of the circle enlarges 


every time you click the button: 

Sub CreateVBActionToClickedEvent () 
"VBA67 

Dim objButton As HMIButton 

Dim objCircle As HMICircle 

Dim objEvent As HMIEvent 

Dim objVBScript As HMIScriptInfo 
Dim strCode As String 


strCode = "Dim myCircle" & vbCrLf & "Set myCircle = " 


strCode = strCode & 


"HMTRuntime.ActiveScreen.ScreenItems (""Circle VB™")" 
strCode = strCode & vbCrLf & "myCircle.Radius = myCircle.Radius + 


ish 
Set objCircle = 


ActiveDocument.HMIObjects.AddHMIObject ("Circle VB", "HMICircle") 


Set objButton = 


ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMIButton") 


With objCircle 

-Top = 100 

-Left = 100 

-BackColor = RGB(255, 0O, OQ) 
End With 

With objButton 

-Top = 10 

-Left = 10 

-Width = 120 

.Text = "Increase Radius" 
End With 

"Define event and assign sourcecode: 
Set objVBScript = 


objButton.Events (1) .Actions.AddAction (hmiActionCreationTypeVBScrip 


t) 

With objVBScript 
-SourceCode = strCode 
End With 

End Sub 


4. Start the procedure with <F5>. 


See also 

Actions Object (Listing) (Page 1898) 

ScriptInfo Object (Page 2058) 

Events Object (Listing) (Page 1967) 

Configuring Event-Driven Actions with VBA (Page 1699) 
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3.3.5.4 Editing Triggers 
Editing Triggers 
Introduction 


You use triggers in connection with dynamics for graphics objects and for triggering actions 
on object properties. Examples of triggers include: 


Tags: When the value of a tag is changed or its limit is exceeded at either extreme 


Standard cycle: Cyclic execution of the action. The length of the cycles is selectable 
between 250 ms and 1 h. In addition, you can also use customized cycles that you define 
yourself. 


Picture cycle: A cyclic trigger is used as the trigger. This cycle provides the option of defining 
the cycles of all the actions, tag connections and dynamic dialogs used in a picture centrally. 


Window Cycle: A cyclic trigger is used as the trigger. This values applies to all actions, tag 
links and dynamic dialogs, which were configured with the trigger type "Window cycle". 


When you configure an action that responds to an event on a graphics object, the triggering 
event is the trigger. 


Configuring triggers with VBA 


Use the Trigger object to configure a trigger with VBA. If you intend to use a variable as the 
trigger, use the VariableTrigger object: 


You determine the type of trigger with the Type property. Use the VariableTriggers property 
when you configure a variable as the trigger. 


See also 


Examples of Editing Triggers with VBA (Page 1708) 
VariableTrigger Object (Page 2099) 

Trigger Object (Page 2087) 

ScriptInfo Object (Page 2058) 
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Examples of Editing Triggers with VBA 


Introduction 
The four examples below illustrate how you can create the following triggers with VBA: 
e Standard cycle 
e Tag 
e Picture cycle 
e Window Cycle 


In all of these examples a circle is inserted into the active picture, with the radius of the circle 
being dynamized with a VB action. 


The procedure for adding dynamics to a property with variable connection is explained under 
"Adding dynamics to a property with a variable connection" in this documentation. 


Example 1: Standard cycle 


Sub DynamicWithStandardCycle () 

"VBA68 

Dim objVBScript As HMIScriptInfo 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle Standard", "HMICircle") 
Set objVBScript = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeVBScript) 

With objVBScript 

-Trigger.Type = hmiTriggerTypeStandardCycle 
"CycleType"-specification is necessary: 


.Trigger.CycleType = hmiCycleType 10s 
.Trigger.Name = "VBA StandardCycle" 
-SourceCode = "" 

End With 

End Sub 


Example 2: Tag 


Sub DynamicWithVariableTriggerCycle() 

"VBA69 

Dim objVBScript As HMIScriptInfo 

Dim objVarTrigger As HMIVariableTrigger 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument .HMIObjects.AddHMIObject ("Circle VariableTrigger", 
"HMTICircle") 

Set objVBScript = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeVBScript) 
With objVBScript 

Set objVarTrigger = .Trigger.VariableTriggers.Add("VarTrigger", hmiVariableCycleType 10s) 
-SourceCode = "™" 

End With 

End Sub 
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Example 3: Picture cycle 


Sub DynamicWithPictureCycle() 

"VBA70 

Dim objVBScript As HMIScriptInfo 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle Picture", "HMICircle") 
Set objVBScript = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeVBScript) 
With objVBScript 

.Trigger.Type = hmiTriggerTypePictureCycl 

.Trigger.Name = "VBA PictureCycle" 

-SourceCode = "" 

End With 

End Sub 


Example 4: Window Cycle 


Sub DynamicWithWindowCycle() 

"VBA7T1 

Dim objVBScript As HMIScriptInfo 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle Window", "HMICircle") 
Set objVBScript = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeVBScript) 
With objVBScript 


a 


.Trigger.Type = hmiTriggerTypeWindowCycle 
.Trigger.Name = "VBA WindowCycle" 
-SourceCode = "™ 

End With 

End Sub 


See also 
VariableTrigger Object (Page 2099) 
Trigger Object (Page 2087) 
ScriptInfo Object (Page 2058) 
Editing Triggers (Page 1707) 


3.3.6 Event Handling 


Introduction 


In the Graphics Designer, events occur when certain actions are taken (for example when a 
picture is opened). You can respond to an event with a predefined VBA event handler in order 
to execute instructions. 
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The events occur only during configuring in the Graphics Designer and are not available in 
Runtime. These events must not be confused with the events (e.g. mouse click, property 
change) occurring on graphic objects and pictures. 


Note 
When the Graphics Designer is open, events are also triggered by other editors. 


. This applies, for example, to the modification of picture properties in WinCCExplorer. Close 
the Graphics Designer when you are making changes to pictures in other editors. This prevents 
events from being executed when you do not want them to be. 


Note 


If you open a picture in Graphics Designer, not only the "DocumentOpened event" of the active 
picture but also that of the "Project Template" and of the "Global Template" are triggered. The 
VBA code of the "DocumentOpened event" is thereby executed twice. 


You must intercept this behavior with the event handler. 


General Procedure 


In event handling there are events with and without forwarding. You can recognize an event 
with forwarding by the presence of the "CancelForwarding" parameter. An event without 
forwarding does not have this parameter. When an event occurs, it is sent to the active picture 
and then forwarded to the "Global Template". 


aktive Picture Project Template Global Template 
(POL TRY (@ PROJECT.PDT) (@GLOBAL.PDT) 


VBA code VBA code VBA code 


An event with forwarding is therefore forwarded by default via the document "Project Template" 
to the document "Global Template". 


Preventing forwarding 


You can prevent the forwarding of an event by setting the "CancelForwarding" parameter to 
"True" in the VBA event handler: 


Sub Document _HMIObjectPropertyChanged (ByVal Property As IHMIProperty, CancelForwarding As 
Boolean) 

"VBA72 

CancelForwarding = True 

sgBox "Object's property has been changed!" 

End Sub 


Picture-specific and application-specific events 


Quite apart from the information given above about events with and without forwarding, the 
Graphics Designer differentiates between picture-specific and application-specific events: 
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Picture-specific events 


Picture-specific events always respond to actions that occur in the active picture in the 
Graphics Designer. Such actions include, for example, the changing of object properties or 
saving the active picture. You can obtain a list of available picture-specific events by choosing 
"Document" in the VBA editor: 


[Document v |HnMlObjectPropertyChanged v | 
Private sub Document _HNIObjectPropertyChanged (, 
Dim objProperty is HMIProperty 


Application-specific events 


Application-specific events respond to actions that occur in the "Graphics Designer" 
application. Such actions include, for example, starting the Graphics Designer or creating an 
object in the component library. 


To make the application-specific events available, write the following statement in the VBA 
editor at the start of the document (preferably the "Project Template" or "Global Template"): 


Dim WithEvents <Name> As grafexe.Application 


The effect of this statement is that it will now also be possible to select the application-specific 
events from the list in the Graphics Designer: 


|objGDApplication v | [Started v | 


Dim WithEvents objGDApplication is grafexe.Application 


— 
~ 
_— 


Private Sub objGDApplication Started() 
MsgBox ("Graphics Designer has been started") 
End Sub 
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Example 1: Occurrence of an event with forwarding 


The illustration shows the sequence that follows from the occurrence of an event with 
forwarding: 


active pre 
Picture ‘ 
? macros 


no 


Event with 
forwarding 
occurs 


CancelForwarding 
= True? 


Proj event execute 
hacia handler YBA CancelForwarding 
Template defined? macros = True? 


yes 


Global ry 
Template : prance 


Note 


There are events which are both picture-specific and application-specific (for example 
BeforeDocumentSave). When such an event occurs, the program checks whether the 
corresponding application-specific event handler has been defined. The sequence shown 
above does not begin until after that. 


Example 2: Occurrence of an event without forwarding 


The illustration shows the sequence that follows from the occurrence of an event without 
forwarding: 


event execute 
handler VBA 
defined? macros 


Event without 
fonwarding 
occurs 


active 
Picture 
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Disabling event handling 


You can disable event handling by setting the "DisableVBAE vents" property for the Application 
object to "True". 


See also 

DisableVBAEvents Property (Page 2214) 

Organizing VBA Code in a WinCC Project (Page 1615) 
3.3.7 Accessing External Applications with VBA 
3.3.7.1 Accessing External Applications with VBA 
Introduction 


You can use VBA to access programs which support VBA, for example products in the 
Microsoft Office family. This enables you, for example, to read out values from an MS Excel 
worksheet and then assign these to object properties. 


Note 
No direct usage of Unicode in Excel VBA and Word VBA 


Excel VBA and Word VBA supports the use of Unicode characters only by means of 
<ChrW(unicode-id) function. 
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Registering an external application 


You have to integrate an external application in the VBA editor in order to make its object library 
available. To do this, select the "References" option in the "Tools" menu in the VBA editor. In 
the "References" dialog you can then select the required object library: 


References - VBAProject1 Ed 


Available References: 


|_|Microsoft Data Access Components Installed Version # 
Microsoft Data Formatting Object Library 
Microsoft Data Source Interfaces 
Microsoft Direct Speech Recognition Browse... 
Microsoft Direct Text-to-Speech 

Microsoft DirectX Transform 1.0 Type Library 4| 
Microsoft Direct Transform 1.0 Type Librar 
MaEMicrosoft Excel 8.0 Object Library 
Microsoft Graph 9.0 Object Library 
Microsoft HTML Object Library +| 
Microsoft Internet Controls 

Microsoft Jet and Replication Objects 2.1 Library 


Microsoft MIMEEDIT Type Library 1.0 of 


icrosoft NetShow 2,0 PowerPoint Add-In Helper 


Microsoft Excel 8.0 Object Library 


Location: C:\Programme\Microsoft Office\OFfice\EXCEL8. OLB 
Language: Standard 


Note 


You must attach the external application to all projects which you want to be able to access 
the external application; do this in the VBA editor Project Explorer. 


See also 

Example: Accessing MS Excel with VBA (Page 1714) 
3.3.7.2 Example: Accessing MS Excel with VBA 
Introduction 


The following three examples illustrate how to access MS Excel. For these examples to work, 
the MS Excel object library must be integrated via a reference. 
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Note 
No direct usage of Unicode in Excel VBA and Word VBA 


Excel VBA and Word VBA supports the use of Unicode characters only by means of 
<ChrW(unicode-id) function. 
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Example 1 


In this example the default object list of the Graphics Designer is exported in an Excel 
worksheet. The object properties are taken into account, as is the question of whether 
dynamics can be used with these properties. The VBA data type is also displayed. 
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Sub ExportDefObjListToXLs () 

'VBA73 

"Microsoft Excel Object Library needs to be referenced 
Dim objGDApplication As grafexe.Application 
Dim objJHMIObject As grafexe.HMIObject 

Dim objProperty As grafexe.HMIProperty 

Dim objXLS As Excel.Application 

Dim objWSheet As Excel.Worksheet 

Dim objJWBook As Excel.Workbook 

Dim rngSelection As Excel.Range 

Dim 1Row As Long 

Dim lRowGroupStart As Long 


"define local errorhandler 
On Local Error GoTo LocErrTrap 


"Set references to the applications Excel and GraphicsDesigner 
Set objGDApplication = grafexe.Application 
Set objJXLS = New Excel.Application 


"Create workbook 
Set objJWBook = objXLS.Workbooks.Add() 
objWBook.SaveAs objGDApplication.ApplicationDataPath & "DefaultObjekte.xls" 


"Adds new worksheet to the new workbook 
Set objWSheet = objJWBook.Worksheets.Add 
objWSheet.Name = "DefaultObjekte" 

1lRow = 1 


"Every object of the DefaultHMIObjects-collection will be written 
"to the worksheet with their objectproperties. 

"For better overview the objects will be grouped. 

For Each objJHMIObject In objGDApplication.DefaultHMIObjects 
DoEvents 
objWSheet.Cells(lRow, 1).value obj HMIObject.ObjectNam 
objWSheet.Cells(lRow, 2).value = objHMIObject.Type 

lRow = 1lRow + 1 

lRowGroupStart = lRow 

For Each objProperty In objHMIObject.Properties 

‘Write displayed name and automationname of property 

‘into the worksheet 

objWSheet.Cells(lRow, 2).value = objProperty.DisplayName 
objWSheet.Cells(lRow, 3).value = objProperty.Name 

‘Write the value of property, datatype and if their dynamicable 


‘into the worksheet 

If Not IsEmpty (objProperty.value) Then _ 

objWSheet.Cells(lRow, 4).value = objProperty.value 

objWSheet.Cells(lRow, 5).value = objProperty.IsDynamicable 

objWSheet.Cells(lRow, 6).value = TypeName (objProperty.value) 

objWSheet.Cells(lRow, 7).value = VarType (objProperty.value) 

lRow = lRow + 1 

Next objProperty 

"Select and groups the range of object-properties in the worksheet 

Set rngSelection = objWSheet.Range (objWSheet .Rows (lRowGroupStart), 
objWSheet.Rows (lRow - 1) ) 
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rngSelection.Select 
rngSelection.Group 

Set rngSelection = Nothing 
‘Insert empty row 

lRow = 1lRow + 1 

Next objHMIObject 
objWSheet.Columns.AutoFit 

Set objWSheet = Nothing 
objWBook.Save 

objWBook.Close 

Set objJWBook = Nothing 

obj XLS .Quit 

Set objXLS = Nothing 

Set objGDApplication = Nothing 
Exit Sub 
rap: 
sgBox Err.Description, , Err.Source 
Resume Next 

End Sub 


= 


ocEkrri 
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Example 2 


In this example all objects of the active picture are exported to an Excel worksheet. The 
properties taken into account are Position X, Position Y, Width, Height and Layer: 
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Sub ExportObjectL 
"VBA74 


Dim objDoc As gra 


Dim objXLS As Exc 
Dim objWSheet As 
Dim objJWBook As E 
Dim 1lRow As Long 


"Define local err 
On Local Error Go 


"Set references o 
Set objGDApplicat 
Set objDoc = objG 
Set objXLS = New 


"Create workbook 


istToXLS () 


fexe. Document 


el. Application 
Excel .Worksheet 
xcel.Workbook 


orhandler 
To LocErrTrap 


n the applications 


DApplication.Active 
Excel .Application 


Dim objJHMIObject As grafexe.HMIObject 
Dim objProperty As grafexe.HMIProperty 


Set objJWBook = objXLS.Workbooks.Add() 


objWBook.SaveAs objGDApplication.ApplicationDataPath & " 


"Create worksheet in the new workbook and write headline 


Dim objGDApplication As grafexe.Application 


Excel and GraphicsDesigner 
ion = grafexe.Application 
Document 


Export.xls" 


'The name of the worksheet is equivalent to the documents name 
Set objWSheet = objJWBook.Worksheets.Add 


objWSheet.Name = 

objWSheet.Cells ( 

objWSheet.Cells(1 
objWSheet.Cells (1 
objWSheet.Cells (1 
objWSheet.Cells(1 
objWSheet.Cells (1 
objWSheet.Cells (1 
objWSheet.Cells (1 
lRow = 3 


"height, pos x, p 
"ActiveX-Control 
For Each objHMIOb 
DoEvents 


objWSheet.Cells (1 
objWSheet.Cells(1l 
If UCase (obj HMIOb 
objWSheet.Cells(1l 
End If 
objWSheet.Cells(1l 
objWSheet.Cells(1l 
objWSheet.Cells (1 
objWSheet.Cells(1 
objWSheet.Cells (1 
lRow = 1lRow + 1 
Next objHMIObject 
objWSheet. Columns 
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obj Doc.Name 


1, 1) = "Objektname" 


) = "Objekttyp" 
) = "ProgID" 

) = "Position X" 
) = "Position Y" 
) = "Width" 

) = “"Hodhe" 

) = "Ebene" 


os y and layer to E 
the ProgID will b 


xcel. 
also 


‘Every objects will be written with their objectproperties width, 


If the object is an 


ject In objDoc.HMIObjects 


Row, 1).value = obj 
Row, 2) .value = obj 
ject.Type) = "HMIAC 
Row, 3).value = obj 
Row, 4) .value = obj 
Row, 5).value = obj 
Row, 6).value = obj 
Row, 7).value = obj 
Row, 8) .value = obj 


-AutoFit 


xported. 


HMTObject.ObjectNam 
HMTObject.Type 
TIVEXCONTROL" Then 
HMIObject.ProgID 
HMIObject.Left 
HMTObject.Top 
HMTObject.Width 
HMTObject.Height 
HMIObject. Layer 
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Set objWSheet = Nothing 
objWBook.Save 

obj WBook.Close 

Set objJWBook = Nothing 

obj XLS .Quit 

Set objXLS = Nothing 

Set objDoc = Nothing 

Set objGDApplication = Nothing 
Exit Sub 
oCErrTrap: 
sgBox Err.Description, , Err.Source 
Resume Next 

End Sub 
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Example 3 


In this example objects are imported from the Excel worksheet created in example 2. The 
properties taken into account are Position X, Position Y, Width, Height and Layer: 
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Sub ImportObjectListFromxXLs () 

"VBA75 

Dim objJGDApplication As grafexe.Application 
Dim objDoc As grafexe.Document 

Dim objJHMIObject As grafexe.HMIObject 

Dim objXLS As Excel.Application 

Dim objWSheet As Excel.Worksheet 

Dim objJWBook As Excel.Workbook 

Dim 1lRow As Long 
Dim strWorkbookName As String 
Dim strWorksheetName As String 
Dim strSheets As String 


‘define local errorhandler 
On Local Error GoTo LocErrTrap 


"Set references on the applications Excel and GraphicsDesigner 
Set objGDApplication = Application 
Set objDoc = objGDApplication.ActiveDocument 
Set objJXLS = New Excel.Application 


"Open workbook. The workbook have to be in datapath of GraphicsDesigner 
strWorkbookName = InputBox("Name of workbook:", "Import of objects") 

Set objJWBook = objXLS.Workbooks.Open(objGDApplication.ApplicationDataPath & 
strWorkbookName) 

If objJWBook Is Nothing Then 

MsgBox "Open workbook fails!" & vbCrLf & "This function is cancled!", vbCritical, "Import 
od objects" 

Set objDoc = Nothing 

Set objGDApplication = Nothing 

Set objXLS = Nothing 

Exit Sub 

End If 


"Read out the names of all worksheets contained in the workbook 

For Each objWSheet In objWBook.Sheets 

strSheets = strSheets & objWSheet.Name & vbCrLf 

Next objWSheet 

strWorksheetName = InputBox("Name of table to import:" & vbCrLf & strSheets, "Import of 
objects") 

Set objWSheet = objWBook.Sheets (strWorksheetName) 

1lRow = 3 


"Import the worksheet as long as in actual row the first column is empty. 
‘Add with the outreaded data new objects to the active document and 
"assign the values to the objectproperties 
With objWSheet 
While (.Cells(lRow, 1).value <> vbNullString) And (Not IsEmpty(.Cells(lRow, 1) .value) ) 
‘Add the objects to the document as its objecttype, 
‘do nothing by groups, their have to create befor 
If (UCase(.Cells(lRow, 2).value) = "HMIGROUP") Then 
Else 

If (UCase(.Cells(lRow, 2).value) = "HMIACTIVEXCONTROL") Then 

Set objJHMIObject = objDoc.HMIObjects.AddActiveXControl (.Cells(lRow, 

1) .value, .Cells(lRow, 3).value) 
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Set objJHMIObject = objDoc.HMIObjects.AddHMIObject(.Cells(lRow, 1).value, .Cells(lRow, 


Else 

2) .value) 
End If 
objHMIObject.Left = .Cells(lRow, 4).value 
obj HMIObject.Top = .Cells(lRow, 5) .value 
objHMIObject.Width = .Cells(lRow, 
objHMIObject.Height = .Cells(lRow, 
objHMIObject.Layer = .Cells(lRow, 

End If 

Set objJHMIObject = Nothing 

lRow = 1Row + 1 

Wend 

End With 


objWBook.Close 

Set objWBook = Nothing 

obj XLS .Quit 

Set objXLS = Nothing 

Set objDoc = Nothing 

Set objJGDApplication = Nothing 
Exit Sub 
oCErrTrap: 
sgBox Err.Description, , Err.Source 
Resume Next 

End Sub 
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3.4 VBA in the WinCC Configuration Studio 


3.4.1 VBA in the WinCC Configuration Studio 
As of WinCC V7.4 the WinCC Configuration Studio supports the VBA interface. 


With VBA, you can access all editors in the WinCC Configuration Studio, for example, to create, 
change, or delete data. VBA access is also supported for editors of WinCC options that are 
integrated in the WinCC Configuration Studio. 


You open the VBA editor in the WinCC Configuration Studio with "Tools > Visual Basic Editor". 


VBA in the WinCC editors 


The WinCC editors, objects and data records in the WinCC Configuration Studio can be 
selected either by name or by index. 


Note 

Notes on VBA scripts in the WinCC Configuration Studio 

Note the following when creating VBA scripts: 

e To access columns and tabs, note the respective WinCC user interface language. 
e Hidden columns can result in incorrect index assignments when editing via scripts. 
e A sequential index over all hierarchical levels is created with an enumeration. 


NOTICE 


Deleting objects 


If you delete individual objects in the Configuration Studio with VBA scripts, associated objects 
are deleted as well. 


Examples: 


@ Message classes and message types including within 
e Tag groups and contained tags 


Important functions: 

DataGrid.Tabs Enumerate tabs 

DataGrid.UsedRange Detect number of data records or rows used 
DataGrid. Rows .Name Detect object type in a DataGrid, e.g. "Tag" 


The following script examples introduce other important functions. 
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Show hidden columns 


To avoid incorrect index assignments, expand the hidden columns. 


Sub ShowAl1lColumns () 


For i = 1 To DataGrid.EntireColumns.Count 
DataGrid. EntireColumns(i).Visible = True 
Next i 
End Sub 


Example "Tag Management, User Administrator, Graphics Designer" 


You can find a detailed example under "Example: VBA in the WinCC Configuration Studio 
(Page 1726)". 


The example contains the following functions: 


Change the user interface language 
To run a script for a specific language, set the user interface language at the beginning of 
the script. 


Select editor in the WinCC Configuration Studio 
Navigation area: Select tree node 


Data area: Use of row names to detect the object type 
To ensure that the script is accesses the correct tab, for example, check the "Name" 
property of the desired row. 


Data area: Select tab 


Data area: Create new data record 
You determine the row for the new data record and write the values in the cells of this row. 


Data area: Change value 


Data area: Delete entry 

To delete a tag in the data area, for example, check if the tag exists and then delete the 
entire row. 

When you delete an object, all associated objects are deleted. If you delete a tag group, 
for example, all tags of the group are deleted. 


Create objects in the Graphics Designer 

To access the class "HMIGO" with VBA, reference the "HMI General Objects 1.0 Type 
Library" in the VBA script. For each created object, you need in the VBA script to reference 
the respective block library. 


3.4.2 Example: VBA in the WinCC Configuration Studio 
This example illustrates the object model used. 
The following actions are performed: 
Example Action 
AddTag Create a tag in Tag Management 
ModifyTag Change the start value of a newly created tag 
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Example Action 

RemoveTag Delete a created tag again 

AddGroup Create a user group in the User Administrator 
RemoveGroup Delete a created user group again 

AddUser Create a user and user group in the User Administrator 
RemoveUser Delete a created user again 


DemoUsageGraphicsDesigner 


Access to the Graphics Designer 


A process picture is created with the "Static text" object. 
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Example: Tag Management, User Administrator, Graphics Designer 


"VBA907 
' Version of this sample: V1.0 


' With WinCC V7.4 CCConfigStudio supports a VBA interface. 


' The following examples should help understanding the provided objectmodel. 


' Warning: 

' When deleting objects which are containers/parent objects 
classes -> message types, tag groups -> tags, ao ar 

' all child objects will be deleted, too. 


" Remarks: 
' User Administrator -> Setting password: Not supported due 


Option Explicit 


'This method will run all available sample methods 
"Please use a new/empty WinCC project 
Sub FullDemo () 


AddTag 

sgBox "Tag created", vbOKOnly, "VBA-Demo" 
odifyTag 

sgBox "Tag modified", vbOKOnly, "VBA-Demo" 
RemoveTag 

sgBox "Tag removed", vbOKOnly, "VBA-Demo" 
AddGroup 

sgBox "User Group created", vbOKOnly, "VBA-Demo" 
AddUser 

sgBox "User created", vbOKOnly, "VBA-Demo" 
RemoveUser 

sgBox "User removed", vbOKOnly, "VBA-Demo" 
RemoveGroup 

sgBox "User group removed", vbOKOnly, "VBA-Demo" 
DemoUsageGraphicsDesigner 

sgBox "Demo finished.", vbOKOnly, "VBA-Demo" 


End Sub 


‘Add a tag in Tag Management 
Sub AddTag () 
newRowNo 


Dim currLang, i, 


"Save currently selected language 
currLang = ConfigStudio. Language 
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"Set language to English 
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ConfigStudio.Language = 1033 


"Select editor "Tag Management" 


% Valid parameters for s 
ConfigStudio.Editors ("Tag 


"Select treenode "Internal 
' Valid parameters for s 


pecifying editor are names and IDs 
anagement") .Select 


tags" 
pecifying treenodes are names and IDs 


NavigationTree.Nodes ("Internal tags") .Select 


"Make sure that the correc 


t tab of DataGrid is selected 


"One possibility is to check the object type of the rows object with its name property: 


"Property "Name" reflects 


the object type of the currently selected DataGrid 


If DataGrid.Rows.Name = "Tag" Then 


turns the number of used rows in DataGrid. 


'UsedRange.EntireRow r 
newRowNo = DataGrid.Us 


dRange.EntireRow.Count + 1 


"Add tag via entering values into cells of the first empty row in DataGrid 


y Valid parameters f 


or specifying columns are names and IDs 


DataGrid.Cells (newRowNo, 1) = "NewTag" 
DataGrid.Cells (newRowNo, "Data type") = "Text tag 16-bit character set" 
End If 


"Reset language 


ConfigStudio.Language = currLang 


End Sub 


"Changes the start value of the previously created tag 


Sub ModifyTag() 


Dim currLang, i 


currLang = ConfigStudio. Language 


ConfigStudio.Language = 1033 

ConfigStudio.Editors ("Tag Management") .Select 

NavigationTree.Nodes ("Internal tags") .Select 

If DataGrid.Rows.Name = "Tag" Then 
"Modify tag property via usage of tag name to specify the row 
DataGrid.Cells("NewTag", "Start Value") = "abc" 

End If 

ConfigStudio.Language = currLang 

End Sub 


"Removes previously created tag 


Sub RemoveTag() 


Dim currLang, i 
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End 


currLang = ConfigStudio. Language 
ConfigStudio.Language = 1033 


ConfigStudio.Editors ("Tag Management") .Select 
NavigationTree.Nodes ("Internal tags") .Select 


If DataGrid.Rows.Name = "Tag" Then 
"Check if tag tag exists via enumerating rows 
For i= 1 To DataGrid.UsedRange.EntireRow.Count 
If DataGrid.Cells(i, "Name") = "NewTag" Then 
"Select the row first before deleting it 
DataGrid.Rows ("NewTag") .Select 
"Delete the whole row 
DataGrid.Rows ("NewTag") .EntireRow.Delete 
End If 


Next 
End If 


ConfigStudio.Language = currLang 


Sub 


"Add a group in User Administrator 


Sub 


End 


AddGroup () 
Dim currLang, i 


currLang = ConfigStudio. Language 
ConfigStudio.Language = 1033 


ConfigStudio.Editors ("User Administrator") .Select 
NavigationTree.Nodes ("User Administrator") .Select 


"Add user group / Example for enumeration of tabs 
For i= 1 To DataGrid.Tabs.Count 
If DataGrid.Tabs(i).Name = "Groups" Then 
DataGrid.Tabs(i).Select 
DataGrid.Cells (DataGrid.UsedRange.EntireRow.Count + 1, 
End If 
Next i 


ConfigStudio.Language = currLang 


Sub 


"Delete previously created user group 


Sub 
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RemoveGroup () 
Dim currLang, i 


currLang = ConfigStudio. Language 
ConfigStudio.Language = 1033 


ConfigStudio.Editors ("User Administrator") .Select 


1) = "NewGroup" 
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NavigationTree.Nodes ("User Administrator") .Select 


For i = 1 To DataGrid.Tabs.Count 
If DataGrid.Tabs(i).Name = "Groups" Then 
DataGrid.Tabs(i).Select 
DataGrid.Rows ("NewGroup") .Select 
( 


DataGrid.Rows ("NewGroup") .EntireRow. Delete 
End If 
Next i 
ConfigStudio.Language = currLang 


End Sub 


"Add an user and a group in User Administrator 
Sub AddUser () 


Dim currLang, i, newRowNo 


currLang = ConfigStudio. Language 
ConfigStudio.Language = 1033 


ConfigStudio.Editors ("User Administrator") .Select 


NavigationTree.Nodes ("User Administrator") .Select 
"Add user 
For i= 1 To DataGrid.Tabs.Count 
If DataGrid.Tabs(i) = "Users" Then 
DataGrid.Tabs(i).Select 
newRowNo = DataGrid.UsedRange.EntireRow.Count + 1 
DataGrid.Cells(newRowNo, "User Name") = "NewUser" 
"NOT SUPPORTED: DataGrid.Cells (newRowNo, "Password") = "MySuperSavePassword" 
DataGrid.Cells (newRowNo, "WebNavigator") = True 
DataGrid.Cells (newRowNo, "Group name") = "NewGroup" 
Exit For 
End If 
Next i 
ConfigStudio.Language = currLang 
End Sub 


"Delete previously created user 
Sub RemoveUser () 


Dim currLang, i 


currLang = ConfigStudio. Language 
ConfigStudio.Language = 1033 


ConfigStudio.Editors ("User Administrator") .Select 
NavigationTree.Nodes ("User Administrator") .Select 


"Remove user 
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For i = 1 To DataGrid.Tabs.Count 
If DataGrid.Tabs(i) = "Users" Then 
DataGrid.Tabs(i).Select 
DataGrid.Rows ("NewUser") .Select 


( 
( 


DataGrid.Rows ("NewUser") .EntireRow.Delete 
Exit For 
End If 
Next i 
ConfigStudio.Language = currLang 
End Sub 
"Sample for using VBA in Graphics Designer via CCConfigStudio 
Sub DemoUsageGraphicsDesigner () 
"Method 1: 
‘Use this code to create programmatically a reference to Graphics Designer Type Library 
Dim appGD, screen 
Set appGD = CreateObject ("grafexe.Application") 
"or 
"Method 2: 


‘Add reference to "WinCC Graphics Designer Type Library V1.0" via menu -> 
References 
"This will also enable IntelliSense functionality 

"Dim appGD As New grafexe.Application 

"Dim screen As grafexe.Document 


appGD.Visible = True 
Set screen = appGD.Documents.Add (1) 


"hmiOpenDocumentTypeVisibl 


'To th 


for 


be able to add screenitems it is necessary to referenc 
each object 
"Dim statTxtObj As HMIStaticText 


Extras -> 


corresponding type library 


"add reference "HMI StaticText Object 1.0 Library" 


Dim statTxtObj 
Set statTxtObj = screen.HMIObjects.AddHMIObject ("Static Text", "HMIStaticText") 
With statTxtObj 
-Top = 50 
-Left = 50 
-Width = 260 
-Height = 60 
-AlignmentTop = 1 
-AlignmentLeft = 1 
.Text = "Screen created and saved." + vbNewLine + "Please close Graphics Designer 
manually." 
End With 


screen.SaveAs appGD.ApplicationDataPath + "SampleScreen.pdl" 


Set statTxtObj = Nothing 
Set screen = Nothing 
Set appGD = Nothing 
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End Sub 


See also 
VBA in the WinCC Configuration Studio (Page 1725) 
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3.5 


3.5.1 


Introduction 


Addins 


Addlns 


An Addin is a code which cannot be viewed and is stored as a DLL. Addins can make new 
functions available by registering the DLL concerned in the operating system and loading 


To you as a user, the advantage of addins is that they provide functions which are tailor made 
for the associated application. For example if you working on different computers during 
configuration and frequently use VBA macros, you can combine these VBA macros in one or 
more addins. When you change to a different computer you need only copy the addin and you 
can then access the customary functions on the new workstation. 


As a developer, you can use the Graphics Designer program library in a development 
environment to create MS Visual Studio 6.0 addins, for example, and protect your code from 
intrusion. 


Addins in the Graphics Designer 


See also 


3.5.2 


Introduction 
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In the Graphics Designer you can use all the addins that have been developed for the Graphics 
Designer and registered in the operating system of the computer you are using for 
configuration. 


You can automatically load an addin when you start the Graphics Designer if you frequently 
need the functions the addins contain. 


When you no longer need the functions of an addin, you can unload it again at any time. 


How to Configure an Addin in the Graphics Designer (Page 1737) 
Example: Creating Add Ins (Page 1738) 
Linking Add Ins (Page 1734) 


Linking Add Ins 


In the Graphics Designer use the Addin Manager to define the way addins that can be used 
in the Graphics Designer will behave on loading. 
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Requirements 


e An add-in must be registered in the operating system, e.g. by entering the "regsvr32 
filename.dll" command at the input prompt. 


e To register VBA addins, "Microsoft Visual Basic for Applications" must be installed. The 
installation is available in the following ways: 


— Microsoft Office: During installation of Microsoft Office products, for example MS Excel 
or MS Word, Visual Basic for Applications is automatically installed at the same time. 


— Later installation from Microsoft Office Setup: You can select to only install Visual Basic 
for Applications in Microsoft Office Setup with the user-defined installation. 


— Download of the VBA Runtime environment: Microsoft offers a download of the VBA 
Runtime environment at the following links: 
- "VBRun60.exe" file for V6.0: http://support.microsoft.com/kb/192461/ (http:// 


support.microsoft.com/kb/192461/) 
- "VBRun60sp6.exe" file for V6.0 SP6: http://support.microsoft.com/kb/290887/ (http:// 


support.microsoft.com/kb/290887/) 


@ Make sure that the current file "MSAddndr.DLL" is integrated together with the VB6 add-in 
DLL. For more detailed information, refer to: 


—  http://support.microsoft.com/kb/192136/ (http://support.microsoft.com/kb/192136/) 
—  http://support.microsoft.com/kb/2792179/ (http://support.microsoft.com/kb/2792179/) 
—  http://support.microsoft.com/kb/957924/ (http://support.microsoft.com/kb/957924/) 
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Starting Addin Manager 


To start the Addin Manager, go to the Graphics Designer and select the command "Macros > 
"Addin Manager": 


x 
Available Add-Ins Load Behavior 


My Add-In Loaded 
Cancel 


ul 


i 


Help 


Description 
Add-In-Projecttemplate 


~ Load Behavior 
IV Loaded/Unloaded 
T” Load on Startup 

[ Command Line 


Automatically Loading an Addin 


If the addin contains new functions that you always need in the Graphics Designer, you can 
load the addin automatically when you open the Graphics Designer. 


To do this go to the Addin Manager, select the addin and enable the "Load on Startup" 
checkbox. 


Note 


Depending on how the addin is programmed, the function contained in the addin can also be 
entered in the menu "Tools > Macros > Addins". You can then start the function just by clicking 
on it. 


Manually Loading or Unloading an Addin 


You can also load an addin manually if you need its functions for particular purposes only (such 
as test routines). 


To load or unload an addin manually, go to the Addin Manager, select the addin and enable 
the "Loaded/Unloaded" checkbox. 
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How to Configure an Addin in the Graphics Designer (Page 1737) 
Example: Creating Add Ins (Page 1738) 
Addins (Page 1734) 
3.5.3 How to Configure an Addin in the Graphics Designer 


Requirements 


An add-in must be registered in the operating system, e.g. by entering the "regsvr32 
filename.dll" command at the input prompt. 


Procedure 
1. Start the Graphics Designer and open the project to which you want to link the addin. 


2. To call the Addin Manager, select the menu command "Tools" > "Addin Manager". 
The Addin Manager opens. The "Available Add-Ins" list shows all the addins that are 
available, together with their current load status: 


Add-In Manager P.4| 


Available Add-Ins Load Behavior 


My Add-In Loaded 


Help | 


Description 
Add-In-Projecttemplate 


~ Load Behavior 
IV Loaded/Unloaded 
Tl” Load on Startup 

J Command Line 


3. For each addin define whether it is to be loaded and if so when. To do this select the addin 
concerned and enable the appropriate checkbox under "Load Behavior". 
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Result 


See also 


3.5.4 


3.5.4.1 


Introduction 


Requirements 


4. To unload an addin, select the addin concerned and disable the "Load/Unload" checkbox 
under "Load Behavior". 


5. Click OK. 


Depending how the addin is programmed, the function contained in the addin is either listed 
in the "Tools" > "AddIns" menu or reacts to an event handler in the Graphics Designer. 


If the addin is started by means of an event handler (e.g. Started Event), the "On Startup" 
checkbox should be enabled for the addin. 


Linking Add Ins (Page 1734) 
Addins (Page 1734) 
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Example: Creating Add Ins 


In order to create Addins, this documentation contains an example for Visual Basic 6.0, which 
creates a runable Addin for use in the Graphic Designer. 


MS Visual Studio 6.0 must be installed on the configuration computer. 


You should have programming experience if you wish to use the sample code as a basis for 
developing addins of your own. 


Example: Program Template for Visual Basic 6.0 


See also 


1738 


Use the event handler "AddInInstance_OnConnection" to generate an instance of the Graphics 
Designer. In order for the addin to be able to access the Graphics Designer, it is mandatory 
to declare the application. 


Example: Creating an Add In with Visual Basic 6.0 (Page 1739) 
Linking Add Ins (Page 1734) 
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3.5.4.2 


Introduction 


Requirement 


Procedure 


ee Graphics Designer 1.0 Type Library 


3.5 Addins 


Example: Creating an Add In with Visual Basic 6.0 


The program code in this example produces a file called "MyAddIn.DLL". So that the add-in 
will work in Graphics Designer, you must enable the "Load on Startup" checkbox for this add- 
in in the AddIn Manager of Graphics Designer. For this purpose you can also use the 
"LoadOnStartup" function in the add-in. 


When you open Graphics Designer the add-in generates a user-defined menu. You can also 
use the "Tools" > "Addins" menu to call the function contained in the add-in. 


In order to create an executable add-in from the sample code, "MS Visual Studio 6.0" must be 
installed on your computer. You must also have referenced "WinCC Graphics Designer 1.0 
Type Library" in "MS Visual Studio 6.0": 


References - Project1 x| 


Available References: 


_| WebNavWinCC 
webyw 1.0 Type Library 

(] Win CC Web Configurator 
C WinCC Common Interfaces 1.0 Type Librar 
7 


AWinCC Graphics Desianer 1.0 Type Library 
WinCC HMIRTGraphics 1.0 Type Library | 
(| WincC HMIRuntime 1.0 Type Library 
__|WinCC ITagSet2Master 1.0 Type Library Priority 
(| WinCC Online Table Control 1.0 Type Library 

WinCC Online Trend Control 1.0 Type Library +| 
(| WinCC VarLoginCfg 1.0 Type Library 
WinCC WebStubs 1.0 Type Library 
|_| WinCCCompressor 1.0 Type Library 
WinCCDownloader 1.0 Type Library 


Location: — d:\Siemens\WinCC\bin\GRAFEXE.EXE 
Language: Standard 


1. Open"MS Visual Studio 6.0" and create a new project. To create a project, go to the "New 


Project" dialog, select the "AddIn" entry and click on OK. 


. In Project Explorer, open the "Designer" folder and double click the entry called "Connect". 


The "Connect (Addin Designer)" dialog opens. 


3. Under "Application", select the entry for "Graphics Designer" and select the "Initial Behavior 


on Loading" for the add-in. Close the "Connect (AddIn Designer)" dialog. 
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4. In Project Explorer, open the "Designer" folder and use the shortcut menu to select the 
command "Display Code" for the "Connect" entry. 
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5. Replace the entire program code with the following program code: 
Option Explicit 


"Reference to the add-in connection 

Dim WithEvents ThisAddin As grafexe.AddInHook 
"Reference to the Graphics Designer Application 
Dim WithEvents GrafApp As grafexe.Application 


"WithEvents AddInInstance IDTExtensibility2 (automatic) 


"This method connects the add-in to the Graphic Designer 
Application 

Private Sub AddInInstance OnConnection (ByVal Application As 
Object, 


ByVal ConnectMode As 


AddInDesignerObjects.ext ConnectMode, _ 

ByVal AddInInst As Object, 
custom() As Variant) 
On Error GoTo AddInInstance OnConnection Error 


" Hook up to the Graphics Designer application. IAddInHookEvents 
interface. 
" It is necessary referencing the application this add-in hooks 


Dim GDApplication As grafexe.Application 
Set GDApplication = Application 
If (Not GDApplication Is Nothing) Then 


' Explanation on filters ( first parameter to 
Addins.Attach() ) 


" sbAddInFilterExecute : Add-in is not shown in the Addin 


menu 


' (ThisAddin Execute() is NOT called) 

" sbAddInFilterNone : Add-in is shown in the AddIn menu 
and by 

; clicking on the AddIn's menu entry 
ThisAddin Execute () 

' is called (see the figure below) 

Set ThisAddin = 
GDApplication.AddIns.Attach(sbAddInFilterNone, "Create Rectangle") 

Set GrafApp = GDApplication 


RegisterApplicationMenus 
End If 
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Exit Sub 


AddInInstance OnConnection Error: 
MsgBox Err.Description 


Private Sub AddInInstance OnDisconnection (ByVal RemoveMode As 
AddiInDesignerObjects.ext DisconnectMode, 


~ custom () As Variant) 
On Error GoTo AddInInstance OnDisconnection Error 


If (RemoveMode = ext dm UserClosed) Then 
RemoveApplicationMenus 

End If 

We ar ae gaa aaa ee gaa ee ee ae ee ete ee cea ee ee ee eee ee ae ee ei es ee ee 

" Release reference to IAddInHookEvents interface - Important 


Set ThisAddin = Nothing 
Set GrafApp = Nothing 
Exit Sub 


AddInInstance OnDisconnection Error: 
MsgBox Err.Description 


"This method describes the 2nd way to make add-in functions 
available in Graphics Designer 

' 

"By adding an application menu in Graphics Designer the menu click 
events can be catched by 

"the MenuItemClicked event from the application object 


Private Sub RegisterApplicationMenus () 

Dim objDocMenu As HMIMenu 

Dim objMenuItem As HMIMenuItem 

Set objDocMenu = GrafApp.CustomMenus.InsertMenu(1, "DocMenul", 
"Doc Menu_1") 


Set objMenuItem = objDocMenu.MenulItems.InsertMenultem(1, 
"dmIteml 1", "My first menu entry") 

Set objMenuItem = objDocMenu.MenulItems.InsertMenultem(2, 
"dmIteml 2", "My second menu entry") 

Set objMenuItem = Nothing 

Set objDocMenu = Nothing 
End Sub 
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Private Sub RemoveApplicationMenus () 
Dim objDocMenu As HMIMenu 
Dim objMenuItem As HMIMenuItem 


For Each objMenulItem In 
GrafApp.CustomMenus ("DocMenul") .MenuItems 
Set objMenuItem = Nothing 

Next objMenuItem 


GrafApp.CustomMenus ("DocMenul") .Delete 


Set objMenuItem = Nothing 
Set objDocMenu = Nothing 
End Sub 
Private Sub AddInInstance Terminate () 


" Release reference to IAddInHookEvents interface - Important 


Set ThisAddin = Nothing 
Set GrafApp = Nothing 


Private Sub GrafApp MenuItemClicked (ByVal MenuItem As 
grafexe.IHMIMenultem) 


Select Case MenulItem.Key 
Case "dmIteml 1" 
TestCalll 
Case "dmIteml 2" 
TestCall2 
Case Else 
Debug.Assert False 
End Select 
End Sub 


"You can call both of the following procedures by clicking the menu 
command in the "DocMenul" 


Sub TestCalll1 () 

Call MsgBox ("AddIn Menu: dmIteml 1 Clicked", vbInformation, 
"GrafApp MenuItemClicked") 
End Sub 
Sub TestCall12 () 

Call MsgBox ("AddIn Menu: dmIteml 2 Clicked", vbInformation, 
"GrafApp MenuItemClicked") 
End Sub 


"Registering an AddInHook creates an object which event 
"can be executed by clicking "Extras\Macros\AddIns\<Registered 
Name>" 


Private Sub ThisAddin Execute () 
MsgBox ("AddIn : Execute! Will create a new Rectangle now") 
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Dim NewShape As HMIObject 
Set NewShape = 
GrafApp.ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", 
"HMTRectangle") 
With NewShape 
-Top = 40 
-Left = 40 
-BackColor = 255 
End With 
MsgBox (NewShape.ObjectName) 
End Sub 
6. Create the add-in, and load it in the Graphics Designer. 
Result 
The next time you open it, Graphics Designer contains a user-defined menu titled 
"Doc_Menu_1". The menu "Tools > Addins" contains an entry called "Create Rectangle", which 
pastes a rectangle into the active picture: 
Window Doc_Menu_1 Help 
Settings... FPS eB ke Qaida 100% » 
AddIn Manager ES a a 
~ ee 
Macros r ai Visual Basic Editor Alt+F11 = 
Text Import & Export... Addins Create Rectangle 
See also 


How to Configure an Addin in the Graphics Designer (Page 1737) 


Example: Creating Add Ins (Page 1738) 
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3.6 VBA Reference 

3.6.1 The object model of the Graphics Designer 
3.6.1.1 VBA Reference 

VBA Object Model 


When you click an object name, you are shown a detailed description. 


Note 


The prefix "HMI" will be omitted from the following descriptions. Note that in the code you must 
prefix objects with "HMI", e.g. "HMISymbolLibrary”. 


Legend: 
CT] Object and Collection 


| Object 


» Objact model exienson available 


Detail vizw available 
Object can te confiqured in multiple 
languag2s 
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Events Object (Listing) (Page 1967) 
SymbolLibraries Object (Listing) (Page 2073) 
Actions Object (Listing) (Page 1898) 
Application Object (Page 1909) 
DataLanguage Object (Page 1941) 
DataLanguages Object (Listing) (Page 1942) 
Document Object (Page 1949) 

Documents Object (Listing) (Page 1952) 
Event Object (Page 1966) 
HMIDefaultObjects Object (Listing) (Page 1985) 
HMIObject Object (Page 1988) 

HMIObjects Object (Listing) (Page 1990) 
Folderltem Object (Page 1972) 

Folderltems Object (Listing) (Page 1973) 
VBA Reference: ActionDynamic (Page 1747) 
VBA Reference: HMlObjects (Page 1749) 
VBA Reference: Languages (Page 1751) 
Layer Object (Page 2001) 

Layers Object (Listing) (Page 2003) 

Menu Object (Page 2009) 

Menus Object (Listing) (Page 2011) 
Menultem Object (Page 2013) 

Menultems Object (Listing) (Page 2015) 
Properties Object (Listing) (Page 2041) 
Toolbar Object (Page 2080) 

Toolbars Object (Listing) (Page 2081) 
Toolbarltem Object (Page 2083) 
Toolbarltems Object (Listing) (Page 2085) 
View Object (Page 2102) 

Views Object (Listing) (Page 2103) 
SelectedObjects object (Listing) (Page 2060) 
SymbolLibrary Object (Page 2074) 

Property Object (Page 2042) 
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3.6.1.2 VBA Reference: ActionDynamic 


VBA Object Model: ActionDynamic 


"ActionDynamic" represents the interface port for dynamics and actions such as scripts, the 
dynamic dialog, the direct connection and the triggers. 


When you click an object name, you are shown a detailed description. 


Legend: 
[ ] Object and Collection 


[ ] Object 


Transfer: Object 
depends on type 


See also 
VBA Reference (Page 1745) 
AnalogResultInfo Object (Page 1907) 
AnalogResultInfos Object (Listing) (Page 1908) 
BinaryResultInfo Object (Page 1918) 
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BitResultInfo Object (Page 1919) 

Actions Object (Listing) (Page 1898) 

DestLink Object (Page 1945) 

DirectConnection Object (Page 1947) 
DynamicDialog Object (Page 1955) 
QualityCodeStateValue Object (Page 2044) 
QualityCodeStateValues Object (Listing) (Page 2046) 
ScriptInfo Object (Page 2058) 

SourceLink Object (Page 2065) 

Trigger Object (Page 2087) 

VariableStateValue Object (Page 2096) 
VariableStateValues Object (Listing) (Page 2097) 
VariableTrigger Object (Page 2099) 
VariableTriggers Object (Listing) (Page 2101) 
ActionType property (Page 2107) 
DynamicStateType property (Page 2219) 
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3.6.1.3 VBA Reference: HMlObjects 


VBA Object Model: HMIObjects 


When you click an object name, you are shown a detailed description. 


i 


& & 
j | i | |Objec 
| HiviDefautobjects | | "Selection "| [__ HMlObjects "| 


HMIObject 


Standard objects Windows objects Special objects Smart objects 


CustomizedObject* 


Circle 


CircleArc 


Ellipse 


EllipseArc 


EllipseSegment 


Line 


PieSegment 


Polygon 


PolyLine 


Rectangle 


RoundRectangle 


ANAAEEAEALE 


Static Text 


Object and List 
Object 


Detail view available. 


| a 


Multilingual object configuration is possible. 
Not in DefaultObjects list. 


* 
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See also 
VBA Reference (Page 1745) 
PolyLine Object (Page 2038) 
GroupDisplay Object (Page 1980) 
3DBarGraph Object (Page 1894) 
ActivexControl Object (Page 1900) 
ApplicationWindow Object (Page 1911) 
Button Object (Page 1921) 
CheckBox Object (Page 1924) 
Circle Object (Page 1928) 
CircularArc Object (Page 1931) 
Line Object (Page 2004) 
OLEObject Object (Page 2023) 
OptionGroup Object (Page 2025) 
PictureWindow Object (Page 2029) 
PieSegment Object (Page 2032) 
Polygon Object (Page 2035) 
Property Object (Page 2042) 
Rectangle Object (Page 2049) 
RoundButton Object (Page 2052) 
RoundRectangle Object (Page 2055) 
Slider object (Page 2062) 
StaticText Object (Page 2067) 
StatusDisplay Object (Page 2070) 
TextList Object (Page 2076) 
Ellipse Object (Page 1957) 
EllipseArc Object (Page 1960) 
EllipseSegment Object (Page 1963) 
GraphicObject Object (Page 1975) 
Group Object (Page 1978) 
HMIDefaultObjects Object (Listing) (Page 1985) 
HMIObject Object (Page 1988) 
HM|Objects Object (Listing) (Page 1990) 
IOField Object (Page 1992) 
BarGraph Object (Page 1914) 
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GroupedObjects Object (Listing) (Page 1983) 
VBA Reference: Languages (Page 1751) 
SelectedObjects object (Listing) (Page 2060) 
CustomizedObject Object (Page 1938) 
FaceplateObject object (Page 1969) 
AdvancedAnalogDisplay object (Page 1901) 
AdvancedStateDisplay object (Page 1905) 


3.6.1.4 VBA Reference: Languages 


VBA Object Model: Languages 
When you click an object name, you are shown a detailed description. 


Legend: 
[| Object and Collection 


i] Object 


See also 
VBA Reference (Page 1745) 
LanguageFont Object (Page 1996) 
LanguageFonts Object (Listing) (Page 1997) 
LanguageText Object (Page 1999) 
LanguageTexts Object (Listing) (Page 2000) 
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3.6.1.5 Events 


A-D 


Activated event 


Description 
Occurs when a picture is activated in the Graphics Designer. This happens when you switch 
between two pictures, for example. 
syntax 
Document Activated (CancelForwarding As Boolean) 
Parameters 
Parameter (Data Type) Description 
CancelForwarding (Boolean) TRUE if the event is not intended to be forwarded. 
Default setting is "False". 
Example: 


In the following example a message is output when the picture is activated: 


Private Sub Document Activated (CancelForwarding As Boolean) 

"VBA76 

sgBox "The document got the focus." & vbCrLf &_ 

"This event (Document Activated) is raised by the document itself" 
End Sub 


See also 
VBA Reference (Page 1745) 
Event Handling (Page 1709) 


BeforeClose Events 
Description 


Occurs immediately before a picture is closed. 
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syntax 

Document BeforeClose (Cancel As Boolean, CancelForwarding As Boolean) 
Parameters 

Parameter (Data Type) Description 

Cancel (Boolean) TRUE if command processing is to be canceled. 

CancelForwarding (Boolean) TRUE if the event is not intended to be forwarded. 

Default setting is "False". 

Example: 


In the following example a message is output before the picture is closed: 


Private Sub Document BeforeClose (Cancel As Boolean, CancelForwarding As Boolean) 
"VBA77 

sgBox "Event Document _BeforeClose is raised" 

End Sub 


See also 
VBA Reference (Page 1745) 


BeforeDocumentClose Event 


Description 


Occurs immediately before the picture is closed. 


syntax 


Note 


To ensure that the application-specific event is available in the project, the application must 
be made known to Graphics Designer. This is done by means of the following statement: 


Dim WithEvents <Name> As grafexe.Application 


In the following example, the name "objGDApplication" is substituted for <Name>. 


obj]GDApplication BeforeDocumentClose (Document As HMIDocument, Cancel 
As Boolean) 
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Parameters 


Example: 


End Sub 


Boolean) 
"VBA78 


End Sub 


See also 


Parameter (Data Type) Description 
Document (HMIDocument) The picture that is going to be closed. 
Cancel (Boolean) TRUE if command processing is to be canceled. 


Carry out the following procedure so that the example shown below will work: 


Private Sub SetApplication () 


have to execute with "F5" first 


"This procedur 
Set objGDApplication = grafexe.Application 


In the following example a message is output before the picture is closed: 


Private Sub objGDApplication BeforeDocumentClose (ByVal Document As IHMIDocument, Cancel As 


sgBox "The document " & Document.Name & " will be closed after press ok" 


VBA Reference (Page 1745) 


BeforeDocumentSave event 


Description 


syntax 


1754 


Occurs immediately before the picture is saved. 


Note 


To ensure that the application-specific event is available in the project, the application must 
be made known to Graphics Designer. This is done by means of the following statement: 


Dim WithEvents <Name> As grafexe.Application 


In the following example, the name "objGDApplication" is substituted for <Name>. 
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objJGDApplication BeforeDocumentSave (Document As HMIDocument, Cancel 
As Boolean) 


Parameters 

Parameter (Data Type) Description 

Document (HMIDocument) The picture that is going to be closed. 

Cancel (Boolean) TRUE if command processing is to be canceled. 
Example: 


Carry out the following procedure so that the example shown below will work: 


Private Sub SetApplication () 

'This procedure have to execute with "F5" first 
Set objGDApplication = grafexe.Application 

End Sub 


In the following example a message is output before the picture is closed: 


Private Sub objGDApplication BeforeDocumentSave (ByVal Document As IHMIDocument, Cancel As 
Boolean) 

"VBA79 

sgBox Document.Name & "-saving will start after press ok." 

End Sub 


See also 
VBA Reference (Page 1745) 


BeforeHMlObjectDelete-Ereignis 


Description 


Occurs immediately before an object in a picture is deleted. 


syntax 


BeforeHMIObjectDelete (ByVal HMIObject As IHMIObject, Cancel As 
Boolean, CancelForwarding As Boolean) 
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Parameters 
Parameter (Data Type) Description 
HM1Object (IHMIObject) Identifies the object to be deleted. 
Cancel (Boolean) TRUE if command processing is to be canceled. 
CancelForwarding (Boolean) TRUE if the event is not intended to be forwarded. 
Default setting is "False". 
Example: 


In the following example a message is output identifying the object to be deleted: 


Private Sub Document BeforeHMIObjectDelete (ByVal HMIObject As IHMIObject, Cancel As 
Boolean, CancelForwarding As Boolean) 

"VBA80 

Dim strObjName As String 

Dim strAnswer As String 

' 

'strObjName" contains the name of the deleted object 

strObjName = HMIObject.ObjectNam 

strAnswer = MsgBox("Are you sure to delete " & strObjName & "?", vbYesNo) 
If strAnswer = vbNo Then 

‘if pressed "No" -> set Cancel to true for prevent delete 

Cancel = True 

End If 

End Sub 


See also 
VBA Reference (Page 1745) 


BeforeLibraryFolderDelete event 


Description 


Occurs immediately before a folder in the components library is deleted. 


syntax 


Note 


To ensure that the application-specific event is available in the project, the application must 
be made known to Graphics Designer. This is done by means of the following statement: 


Dim WithEvents <Name> As grafexe.Application 


In the following example, the name "objGDApplication" is substituted for <Name>. 
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objGDApplication BeforeLibraryFolderDelete (LibObject As 
HMIFolderItem, Cancel As Boolean) 


Parameter (Optional) 


Parameter (Data Type) Description 
LibObject (HMIFolderltem) The folder that is going to be deleted. 
Cancel (Boolean) TRUE if command processing is to be canceled. 


Example: 
Carry out the following procedure so that the example shown below will work: 


Private Sub SetApplication () 

'This procedure have to execute with "F5" first 
Set objGDApplication = grafexe.Application 

End Sub 


In the following example a message is output before a folder in the components library is 
deleted: 


Private Sub objGDApplication_BeforeLibraryFolderDelete (ByVal LibObject As HMIFolderItem, 
Cancel As Boolean) 

"VBA81 

sgBox "The library-folder " & LibObject.Name & " will be delete..." 

End Sub 


See also 
VBA Reference (Page 1745) 


BeforeLibraryObjectDelete event 


Description 


Occurs immediately before an object in the components library is deleted. 
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syntax 
Note 
To ensure that the application-specific event is available in the project, the application must 
be made known to Graphics Designer. This is done by means of the following statement: 
Dim WithEvents <Name> As grafexe.Application 
In the following example, the name "objGDApplication" is substituted for <Name>. 
objJGDApplication BeforeLibraryObjectDelete (LibObject As 
HMIFolderItem, Cancel As Boolean) 
Parameter (Optional) 
Parameter (Data Type) Description 
LibObject (HMIFolderltem) The object that is going to be deleted. 
Cancel (Boolean) TRUE if command processing is to be canceled. 
Example: 


Carry out the following procedure so that the example shown below will work: 


Private Sub SetApplication () 

"This procedure have to execute with "F5" first 
Set objGDApplication = grafexe.Application 

End Sub 


In the following example a message is output before a folder in the components library is 
deleted: 


Private Sub objGDApplication_ BeforeLibraryObjectDelete (ByVal LibObject As HMIFolderItem, 
Cancel As Boolean) 

"VBA82 

sgBox "The object " & LibObject.Name & " will be delete..." 

End Sub 


See also 
VBA Reference (Page 1745) 
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BeforeQuit Event 


Description 


Occurs immediately before the Graphics Designer is closed. 


syntax 
Note 
To ensure that the application-specific event is available in the project, the application must 
be made known to Graphics Designer. This is done by means of the following statement: 
Dim WithEvents <Name> As grafexe.Application 
In the following example, the name "objGDApplication" is substituted for <Name>. 
objGDApplication BeforeQuit (Cancel As Boolean) 
Parameters 
Parameter (Data Type) Description 
Cancel (Boolean) TRUE if command processing is to be canceled. 
Example: 


Carry out the following procedure so that the example shown below will work: 


Private Sub SetApplication () 

'This procedure have to execute with "F5" first 
Set objGDApplication = grafexe.Application 

End Sub 


In this example a message is output shortly before the Graphics Designer is closed. 


Private Sub objGDApplication BeforeQuit (Cancel As Boolean) 
"VBA83 

sgBox "The Graphics Designer will be shut down" 

End Sub 
See also 


VBA Reference (Page 1745) 
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BeforeSave Event 


Description 
Occurs immediately before a picture is saved. 
syntax 
Document BeforeSave(Cancel As Boolean, CancelForwarding As Boolean) 
Parameters 
Parameter (Data Type) Description 
Cancel (Boolean) TRUE if command processing is to be canceled. 
CancelForwarding (Boolean) TRUE if the event is not intended to be forwarded. 
Default setting is "False". 
Example: 


In the following example a message is output before the picture is saved: 


Private Sub Document _BeforeSave(Cancel As Boolean, CancelForwarding As Boolean) 
"VBA84 

sgBox "The document will be saved..." 

End Sub 


See also 
VBA Reference (Page 1745) 


BeforeVisibleFalse event 


Description 
Occurs immediately before the Graphics Designer application is set from Visible to Invisible. 


syntax 


Document BeforeVisibleFalse (Cancel As Boolean, CancelForwarding As 
Boolean) 
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Parameters 
Parameter (Data Type) Description 
Cancel (Boolean) TRUE if command processing is to be canceled. 
CancelForwarding (Boolean) TRUE if the event is not intended to be forwarded. 
Default setting is "False". 
Example: 
See also 


VBA Reference (Page 1745) 


ConnectionEvent Event 


Description 
Occurs when two objects are connected via the connector. 


syntax 


ConnectionEvent (eConnEventType, HMIConnector, HMIConnectedObject, 
CancelProcess, CancelForwarding) 


Parameter (Optional) 


Parameter (Data Type) Description 

eConnEventType (HMIConnectionEventType) -- 

HM Connector (HMIObject) -- 

HM IConnectedObject (HMIObject) -- 

CancelProcess (Boolean) TRUE if command processing is to be canceled. 


CancelForwarding (Boolean) TRUE if the event is not intended to be forwarded. 
Default setting is "False". 


Example: 


See also 
VBA Reference (Page 1745) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 1761 


VBA for Automated Configuration 
3.6 VBA Reference 


DataLanguageChanged Event 


Description 
Occurs when the project language has been changed. 


syntax 


Note 


To ensure that the application-specific event is available in the project, the application must 
be made known to Graphics Designer. This is done by means of the following statement: 


Dim WithEvents <Name> As grafexe.Application 


In the following example, the name "objGDApplication" is substituted for <Name>. 


objJGDApplication DataLanguageChanged(1CID As Long) 


Parameters 


Parameter (Data Type) Description 


ICID (Long) The project language identifier 


Example: 
Carry out the following procedure so that the example shown below will work: 


Private Sub SetApplication () 

'This procedure have to execute with "F5" first 
Set objGDApplication = grafexe.Application 

End Sub 


In the following example the newly set project language is output: 


Private Sub objGDApplication DataLanguageChanged (ByVal 1CID As Long) 

"VBA87 

sgBox "The datalanguage is changed to " & Application.CurrentDataLanguage & "." 
End Sub 


See also 
Language-Dependent Configuration with VBA (Page 1624) 
VBA Reference (Page 1745) 
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DesktopLanguageChanged event 


Description 


Occurs when the user interface language has been changed. 


syntax 


Note 


To ensure that the application-specific event is available in the project, the application must 
be made known to Graphics Designer. This is done by means of the following statement: 


Dim WithEvents <Name> As grafexe.Application 


In the following example, the name "objGDApplication" is substituted for <Name>. 


objGDApplication DesktopLanguageChanged(1CID As Long) 


Parameters 


Parameter (Data Type) Description 
ICID (Long) The user interface language identifier 


Example: 


Carry out the following procedure so that the example shown below will work: 


Private Sub SetApplication () 

'This procedure have to execute with "F5" first 
Set objGDApplication = grafexe.Application 

End Sub 


In the following example the newly set desktop language is output: 


Private Sub objGDApplication_DesktopLanguageChanged(ByVal 1CID As Long) 

"VBA88 

sgBox "The desktop-language is changed to " & Application.CurrentDesktopLanguage & "." 
End Sub 


See also 
VBA Reference (Page 1745) 
Language-Dependent Configuration with VBA (Page 1624) 
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DocumentActivated Event 


Description 
Occurs when a picture is activated in the Graphics Designer. This happens when you switch 
between two pictures, for example. 
syntax 
Note 
To ensure that the application-specific event is available in the project, the application must 
be made known to Graphics Designer. This is done by means of the following statement: 
Dim WithEvents <Name> As grafexe.Application 
In the following example, the name "objGDApplication" is substituted for <Name>. 
objJGDApplication DocumentActivated(Document As HMIDocument) 
Parameters 
Parameter (Data Type) Description 
Document (HMIDocument) The picture that is to be activated. 
Example: 


Carry out the following procedure so that the example shown below will work: 


Private Sub SetApplication () 

'This procedure have to execute with "F5" first 
Set objGDApplication = grafexe.Application 

End Sub 


In the following example a message is output identifying the picture that has been activated: 


Private Sub objGDApplication DocumentActivated (ByVal Document As IHMIDocument) 
"VBA89 

sgBox "The document " & Document.Name & " got the focus." & vbCrLf &_ 

"This event is raised by the application." 

End Sub 


See also 
VBA Reference (Page 1745) 
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DocumentCreated Event 


Description 


Occurs when a new picture has been created in the Graphics Designer. 


syntax 


Note 


To ensure that the application-specific event is available in the project, the application must 
be made known to Graphics Designer. This is done by means of the following statement: 


Dim WithEvents <Name> As grafexe.Application 


In the following example, the name "objGDApplication" is substituted for <Name>. 


objJGDApplication DocumentCreated(Document As HMIDocument) 


Parameters 


Parameter (Data Type) Description 


Document (HMIDocument) The picture that has been created. 


Example: 


Carry out the following procedure so that the example shown below will work: 


Private Sub SetApplication () 

'This procedure have to execute with "F5" first 
Set objGDApplication = grafexe.Application 

End Sub 


In the following example the name of the newly created picture is output: 


Private Sub objGDApplication_DocumentCreated (ByVal Document As IHMIDocument) 
'VBA90 

sgBox Document.Name & " will be created." 

End Sub 


See also 
VBA Reference (Page 1745) 
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DocumentOpened Event 


Description 
Occurs when a picture has been opened. 
syntax 
Note 
To ensure that the application-specific event is available in the project, the application must 
be made known to Graphics Designer. This is done by means of the following statement: 
Dim WithEvents <Name> As grafexe.Application 
In the following example, the name "objGDApplication" is substituted for <Name>. 
objJGDApplication DocumentOpened (Document As HMIDocument) 
Parameters 
Parameter (Data Type) Description 
Document (HMIDocument) The picture that has been opened. 
Example: 


Carry out the following procedure so that the example shown below will work: 


Private Sub SetApplication () 

'This procedure have to execute with "F5" first 
Set objGDApplication = grafexe.Application 

End Sub 


In the following example a message is output identifying the picture that has been opened: 


Private Sub objGDApplication_DocumentOpened (ByVal Document As IHMIDocument) 
"VBA91 

sgBox Document.Name & " is opened." 

End Sub 


See also 
VBA Reference (Page 1745) 
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DocumentSaved Event 


Description 


Occurs when a picture has been saved in the Graphics Designer. 


syntax 


Note 


To ensure that the application-specific event is available in the project, the application must 
be made known to Graphics Designer. This is done by means of the following statement: 


Dim WithEvents <Name> As grafexe.Application 


In the following example, the name "objGDApplication" is substituted for <Name>. 


objJGDApplication DocumentSaved (Document As HMIDocument) 


Parameters 


Parameter (Data Type) Description 


Document (HMIDocument) The picture that has been saved. 


Example: 


Carry out the following procedure so that the example shown below will work: 


Private Sub SetApplication () 

'This procedure have to execute with "F5" first 
Set objGDApplication = grafexe.Application 

End Sub 


In the following example a message is output identifying the picture that has been saved: 


Private Sub objGDApplication_DocumentSaved (ByVal Document As IHMIDocument) 
'VBA92 

sgBox Document.Name & " is saved." 

End Sub 


See also 
VBA Reference (Page 1745) 
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DocumentPropertyChanged event 


Description 
Occurs when a picture property is changed. 
syntax 
Document DocumentPropertyChanged (ByVal Property As IHMIProperty, 
CancelForwarding As Boolean) 
Parameters 
Parameter (Data Type) Description 
Property (IHMIProperty) Identifies the changed property. 
CancelForwarding (Boolean) TRUE if the event is not intended to be forwarded. 
Default setting is "False". 
Example: 


In the following example a message is output identifying the picture property being changed: 


Private Sub Document _DocumentPropertyChanged (ByVal Property As IHMIProperty, 
CancelForwarding As Boolean) 

"VBA93 

Dim strPropName As String 

'strPropName" contains the name of the modified property 


strPropName = Property.Name 

sgBox "The picture-property " & strPropName & " is modified..." 
End Sub 
See also 


VBA Reference (Page 1745) 


F-Z 


HMlIObjectAdded Event 


Description 


Occurs when an object is added. 
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syntax 
Document HMIObjectAdded (ByVal HMIObject As IHMIObject, 
CancelForwarding As Boolean) 

Parameters 
Parameter (Data Type) Description 
HMlObject (IHMlObject) Identifies the object being added. 
CancelForwarding (Boolean) TRUE if the event is not intended to be forwarded. 

Default setting is "False". 
Example: 


In the following example a message is output identifying the object that has been added: 


Private Sub Document _HMIObjectAdded (ByVal HMIObject As IHMIObject, CancelForwarding As 


Boolean) 
'VBA94 
Dim strObjName As String 


''strObjName" contains the name of the added object 


strObjName = HMIObject.ObjectNam 


sgBox "Object " & strObjName & " is added... 
End Sub 


See also 
VBA Reference (Page 1745) 


HMlIObjectMoved Event 


Description 


Occurs when an object is moved. 


syntax 


Document HMIObjectMoved (ByVal HMIObject As IHMIObject, 


CancelForwarding As Boolean) 
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Parameters 
Parameter (Data Type) Description 
HM Object (IHMIObject) Identifies the object being moved. 
CancelForwarding (Boolean) TRUE if the event is not intended to be forwarded. 
Default setting is "False". 
Example: 


In the following example a message is output identifying the object that has been moved: 


Private Sub Document _HMIObjectMoved (ByVal HMIObject As IHMIObject, CancelForwarding As 


Boolean) 
"VBA95 
Dim strObjName As String 


''strObjName" contains the nam 
strObjName = HMIObject.ObjectNam 
sgBox "Object " & strObjName & " was moved..." 
End Sub 


of the moved object 


See also 
VBA Reference (Page 1745) 


HMlObjectPropertyChanged Event 


Description 
Occurs when an object property is changed. 
syntax 
Document HMIObjectPropertyChanged (ByVal Property As IHMIProperty, 
CancelForwarding As Boolean) 
Parameters 
Parameter (Data Type) Description 
Property (IHMIProperty) Identifies the changed property. 
CancelForwarding (Boolean) TRUE if the event is not intended to be forwarded. 
Default setting is "False". 
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Example: 


In the following example a message is output identifying the object property that has been 


changed: 


Private Sub Document HMIObjectPropertyChanged (ByVal Property As IHMIProperty, 
CancelForwarding As Boolean) 

"VBA96 

Dim strObjProp As String 

Dim strObjName As String 

Dim varPropValue As Variant 

' 

'strObjProp" contains the name of the modified property 

''varPropValue" contains the new value 

strObjProp = Property.Name 

varPropValue = Property.value 

' 

'’strObjName" contains the name of the selected object, 

‘which property is modified 

strObjName = Property.Application.ActiveDocument.Selection (1) .ObjectName 


sgBox "The property " & strObjProp & " of object " & strObjName & " is modified... 
vbCrLf & "The new value is: " & varPropValue 
End Sub 
See also 


VBA Reference (Page 1745) 


HMlObjectResized Event 


Description 
Occurs when the size of an object is changed. 

syntax 
Document HMIObjectResized(ByVal HMIObject As IHMIObject, 
CancelForwarding As Boolean) 

Parameters 
Parameter (Data Type) Description 
HM1Object (IHMIObject) Identifies the object that is being resized. 
CancelForwarding (Boolean) TRUE if the event is not intended to be forwarded. 

Default setting is "False". 
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Example: 


In the following example a message is output when an object has been resized: 


Private Sub Document HMIObjectResized(ByVal HMIObject As IHMIObject, CancelForwarding As 
Boolean) 
"VBA97 


Dim strObjName As String 

' 

'strObjName" contains the name of the modified object 
strObjName = HMIObject.ObjectNam 

sgBox "The size of " & strObjName & " was modified..." 
End Sub 


See also 
VBA Reference (Page 1745) 


LibraryFolderRenamed Event 


Description 


Occurs when a folder in the components library has been renamed. 


syntax 


Note 


To ensure that the application-specific event is available in the project, the application must 
be made known to Graphics Designer. This is done by means of the following statement: 


Dim WithEvents <Name> As grafexe.Application 


In the following example, the name "objGDApplication" is substituted for <Name>. 


objGDApplication LibraryFolderRenamed(LibObject As HMIFolderItem, 
OldName As String) 


Parameters 


Parameter (Data Type) Description 


LibObject (HMIFolderltem) The renamed folder. 


OldName (String) The original name of the renamed folder. 
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Example: 


Carry out the following procedure so that the example shown below will work: 


Private Sub SetApplication () 

'This procedure have to execute with "F5" first 
Set objGDApplication = grafexe.Application 

End Sub 


In the following example the old and new folder names are output: 


Private Sub objGDApplication_LibraryFolderRenamed(ByVal LibObject As HMIFolderItem, ByVal 
OldName As String) 

"VBA98 

sgBox "The Library-folder " & OldName & " is renamed in: " & LibObject.DisplayName 

End Sub 


See also 
VBA Reference (Page 1745) 
Accessing the component library with VBA (Page 1646) 


LibraryObjectRenamed Event 


Description 


Occurs when an object in the components library has been renamed. 


syntax 


Note 


To ensure that the application-specific event is available in the project, the application must 
be made known to Graphics Designer. This is done by means of the following statement: 


Dim WithEvents <Name> As grafexe.Application 


In the following example, the name "objGDApplication" is substituted for <Name>. 


objGDApplication LibraryObjectRenamed(LibObject As HMIFolderItem, 
OldName As String) 
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Parameters 

Parameter (Data Type) Description 

LibObject (HMIFolderltem) The renamed object. 

OldName (String) The original name of the renamed object. 
Example: 


Carry out the following procedure so that the example shown below will work: 


Private Sub SetApplication () 

'This procedure have to execute with "F5" first 
Set objGDApplication = grafexe.Application 

End Sub 


In the following example the old and new object names are output: 


Private Sub objGDApplication LibraryObjectRenamed (ByVal LibObject As IHMIFolderItem, ByVal 
OldName As String) 

"VBA99 

sgBox "The object " & OldName & " is renamed in: " & LibObject.DisplayName 

End Sub 


See also 
VBA Reference (Page 1745) 
Accessing the component library with VBA (Page 1646) 


LibraryObjectAdded Event 


Description 


Occurs when an object has been added to the components library. 


syntax 


HMIObjectPropertyChanged (ByVal Property As IHMIProperty, 
CancelForwarding As Boolean) 
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Parameters 
Parameter (Data Type) Description 
LibObject (IHMIFolderltem) Identifies the library object. 
CancelForwarding (Boolean) TRUE if the event is not intended to be forwarded. 
Default setting is "False". 
Example: 


In the following example a message is output when an object has been added to the 
components library: 


Private Sub Document LibraryObjectAdded (ByVal LibObject As IHMIFolderItem, 
CancelForwarding As Boolean) 
'VBA100 


Dim strObjName As String 

' 

''strObjName" contains the name of the added object 
strObjName = LibObject.DisplayName 


sgBox "Object " & strObjName & " was added to the picture." 
End Sub 


See also 
VBA Reference (Page 1745) 


MenultemClicked Event 


Description 


Occurs when an entry in a user-defined menu is clicked. 


Note 
This event is both application-specific and document-specific. 


To ensure that the application-specific event is available in the project, the application must 
be made known to Graphics Designer. This is done by means of the following statement: 


Dim WithEvents <Name> As grafexe.Application 


syntax 


Document MenuItemClicked (ByVal MenuItem As IHMIMenulItem) 
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Parameters 
Parameter (Data Type) 
Menultem (IHMIMenultem) Identifies the user-defined menu. 

Example: 


Carry out the following procedure so that the example shown below will work: 


Private Sub SetApplication () 

'This procedure have to execute with "F5" first 
Set objGDApplication = grafexe.Application 

End Sub 


In the following example a message is output when the first entry in a user-defined menu is 
clicked: 


Private Sub Document MenuItemClicked (ByVal Menultem As IHMIMenulItem) 
"'VBA1OL 

Dim objMenuItem As HMIMenuItem 

Dim varMenuItemKey As Variant 

Set objMenuItem = MenuItem 


'objMenultem" contains the clicked menu-item 
''yvarMenultemKey" contains the value of parameter "Key" 
‘from the clicked userdefined menu-item 

varMenultemKey = objMenulItem.Key 

Select Case Menultem.Key 

Case "mIteml 1" 


sgBox "The first menu-item was clicked!" 

End Select 

End Sub 

See also 
How to assign VBA macros to menus and toolbars (Page 1642) 
VBA Reference (Page 1745) 

NewLibraryFolder Event 

Description 


Occurs when a folder has been created in the components library. 
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syntax 
Note 
To ensure that the application-specific event is available in the project, the application must 
be made known to Graphics Designer. This is done by means of the following statement: 
Dim WithEvents <Name> As grafexe.Application 
In the following example, the name "objGDApplication" is substituted for <Name>. 
obj]GDApplication NewLibraryFolder (LibObject As HMIFolderItem) 
Parameters 
Parameter (Data Type) Description 
LibObject (HMIFolderltem) The newly created folder. 
Example: 


Carry out the following procedure so that the example shown below will work: 


Private Sub SetApplication () 

'This procedure have to execute with "F5" first 
Set objGDApplication = grafexe.Application 

End Sub 


In the following example the new folder name is output: 


Private Sub objGDApplication NewLibraryFolder (ByVal LibObject As IHMIFolderItem) 
"VBA102 
sgBox "The library-folder " & LibObject.DisplayName & " was added." 


End Sub 
See also 
VBA Reference (Page 1745) 
Accessing the component library with VBA (Page 1646) 
NewLibraryObject Event 
Description 


Occurs when an object has been created in the components library. 
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syntax 


Note 


To ensure that the application-specific event is available in the project, the application must 
be made known to Graphics Designer. This is done by means of the following statement: 


Dim WithEvents <Name> As grafexe.Application 


In the following example, the name "objGDApplication" is substituted for <Name>. 


objGDApplication NewLibraryObject (LibObject As HMIFolderItem) 


Parameters 


Parameter (Data Type) Description 
LibObject (HMIFolderltem) The newly created object. 


Example: 


Carry out the following procedure so that the example shown below will work: 


Private Sub SetApplication () 

'This procedure have to execute with "F5" first 
Set objGDApplication = grafexe.Application 

End Sub 


In the following example the new object name is output: 


Private Sub objGDApplication NewLibraryObject (ByVal LibObject As IHMIFolderItem) 
"VBA103 

sgBox "The object " & LibObject.DisplayName & " was added." 

End Sub 


See also 
VBA Reference (Page 1745) 
Accessing the component library with VBA (Page 1646) 


Opened Event 


Description 


Occurs when a picture is opened. 
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syntax 
Document Opened (CancelForwarding As Boolean) 
Parameters 
Parameter (Data Type) 
CancelForwarding (Boolean) TRUE if the event is not intended to be forwarded. 
Default setting is "False". 
Example: 


In the following example a message is output when the picture is opened: 


Private Sub Document _Opened(CancelForwarding As Boolean) 
"VBA104 
sgBox "The Document is open now..." 
End Sub 
See also 


VBA Reference (Page 1745) 


Saved Event 


Description 
Occurs after a picture has been saved. 
syntax 
Document Saved(CancelForwarding As Boolean) 
Parameters 
Parameter (Data Type) Description 
CancelForwarding (Boolean) TRUE if the event is not intended to be forwarded. 


Default setting is "False". 
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Example: 


In the following example a message is output when the picture has been saved: 


Private Sub Document _Saved(CancelForwarding As Boolean) 
"VBA105 
sgBox "The document is saved..." 
End Sub 
See also 


VBA Reference (Page 1745) 


SelectionChanged Event 


Description 

Occurs when the selection has been changed. 
syntax 

Document SelectionChanged(CancelForwarding As Boolean) 
Parameters 

Parameter (Data Type) Description 
CancelForwarding (Boolean) TRUE if the event is not intended to be forwarded. 
Default setting is "False". 

Example: 


In the following example a message is output when a new object has been selected: 


Private Sub Document _SelectionChanged(CancelForwarding As Boolean) 
"VBA106 
sgBox "The selection is changed..." 
End Sub 
See also 


VBA Reference (Page 1745) 
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Description 
Occurs when the Graphics Designer has been started. 
Syntax 
objGDApplication Started () 
Note 
To ensure that the application-specific event is available in the project, the application must 
be made known to Graphics Designer. This is done by means of the following statement: 
Dim WithEvents <Name> As grafexe.Application 
In the following example, the name "objGDApplication" is substituted for <Name>. 
Parameters 
Example 


Declare application. 


Dim WithEvents objGDApplication As grafexe.Application 


Set event tag. 


Private Sub Document _Opened(CancelForwarding As Boolean) 
Set objGDApplication = Me.Application 
End Sub 


Query "Started" event and output message. 


Private Sub objGDApplication_ Started () 

'VBA1O7 

'This event is raised before objGDApplication Started() 
MsgBox "The Graphics Designer is started!" 

End Sub 
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See also 
VBA Reference (Page 1745) 


ToolbarltemClicked Event 


Description 
Occurs when an icon in a user-defined toolbar has been clicked 


Note 
This event is both application-specific and document-specific. 


To ensure that the application-specific event is available in the project, the application must 
be made known to Graphics Designer. This is done by means of the following statement: 


Dim WithEvents <Name> As grafexe.Application 


syntax 
Document ToolbarItemClicked (ByVal ToolbarItem As IHMIToolbarItem) 


Parameters 


Parameter (Data Type) Description 
Toolbarltem (IHMIToolbarltem) Identifies the symbol. 


Example: 
Carry out the following procedure so that the example shown below will work: 


Private Sub SetApplication () 

'This procedure have to execute with "F5" first 
Set objGDApplication = grafexe.Application 

End Sub 
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In the following example a message is output when the first user-defined icon is clicked: 


Private Sub Document _ToolbarItemClicked(ByVal ToolbarItem As IHMIToolbarItem) 
"'VBA108 

Dim objToolbarItem As HMIToolbarItem 

Dim varToolbarItemKey As Variant 

Set objToolbarItem = ToolbarItem 


'varToolbarItemKey" contains the value of parameter "Key" 
‘from the clicked userdefined toolbar-item 
varToolbarItemKey = objToolbarItem.Key 


Select Case varToolbarItemKey 

Case "tIteml 1" 

sgBox "The first Toolbar-Icon was clicked!" 
End Select 

End Sub 


See also 
How to assign VBA macros to menus and toolbars (Page 1642) 


VBA Reference (Page 1745) 


ViewCreated Event 


Description 
Occurs when a copy of a picture has been created. 


Note 
This event is both application-specific and document-specific. 


To ensure that the application-specific event is available in the project, the application must 
be made known to Graphics Designer. This is done by means of the following statement: 


Dim WithEvents <Name> As grafexe.Application 


syntax 


Document ViewCreated (ByVal pView As IHMIView, CancelForwarding As 
Boolean) 
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Parameters 
Parameter (Data Type) Description 
pView (IHMIView) Identifies the copy of the picture. 
CancelForwarding (Boolean) TRUE if the event is not intended to be forwarded. 
Default setting is "False". 
Example: 


Carry out the following procedure so that the example shown below will work: 


Private Sub SetApplication () 

'This procedure have to execute with "F5" first 
Set objGDApplication = grafexe.Application 

End Sub 


In the following example the number of copy pictures is output when a new copy of the picture 
has been created. 


Private Sub Document _ViewCreated(ByVal pView As IHMIView, CancelForwarding As Boolean) 
"VBA109 

Dim iViewCount As Integer 

' 

'To read out the number of views 

iViewCount = pView.Application.ActiveDocument.Views.Count 

sgBox "A new copy of the picture (number " & iViewCount & ") was created." 

End Sub 


See also 
VBA Reference (Page 1745) 


WindowStateChange Event 


Description 


Occurs when the window size is changed (e.g. from "Minimized" to "Maximized"). 


syntax 


objJGDApplication WindowStateChanged () 
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Parameter (Optional) 


Example: 


In the following example a message is output when the window size is changed: 


Private Sub objGDApplication WindowStateChanged() 
'VBA110 
sgBox "The state of the application-window is changed!" 
End Sub 
See also 
VBA Reference (Page 1745) 
3.6.1.6 Methods 
A-C 
Activate Method 
Description 
Activates the specified object. 
syntax 
Expression.Activate () 
Expression 
Necessary. An expression or element which returns an object of the "Application" or "View" 
type. 
Parameters 
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Example: 


In the following example a copy of the active picture is created and then activated: 


Sub CreateAndActivateView () 

'VBA111 

Dim objView As HMIView 

Set objView = ActiveDocument.Views.Add 
objView.Activate 


End Sub 
See also 
View Object (Page 2102) 
Application Object (Page 1909) 
VBA Reference (Page 1745) 
Add Method 
Description 
Adds another element to a listing. 
The following table shows you the listings to which the Add method can be applied. The 
parameters and syntax for the respective Add methods can be found under "Methods". 
Listing Application for the Add Method 
AnalogResultInfos Listing Adds a new, analog value range in the Dynamic 
dialog. 
Documents Listing Creates a new picture in the Graphics Designer 
GroupedObjects Listing Adds a new object to a group object. 
Toolbars Listing Creates a new, user-defined toolbar. 
Tag Triggers Listing Creates a new tag trigger. 
Views Listing Creates a copy of the specified picture. 
See also 
Add Method (Views Listing) (Page 1793) 
Add Method (TagTriggers Listing) (Page 1792) 
Add Method (CustomToolbars Listing) (Page 1788) 
Add Method (GroupedObjects Listing) (Page 1791) 
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Add Method (Documents Listing) (Page 1790) 
Add Method (AnalogResultInfos Listing) (Page 1787) 


Add Method (AnalogResultInfos Listing) 


Description 
Adds a new, analog value range in the Dynamic dialog. 
syntax 
Expression.Add (RangeTo, ResultValue) 
Expression 
Necessary. An expression or element which returns an object of the "AnalogResultInfos" type. 
Parameters 
Parameter (Data Type) Description 
RangeTo (Variant) The value range to which the change of property 
gives rise. 
ResultValue (Variant) The value to which the object property is assigned 
when the value range is reached. 
Example: 


In the following example the radius of a circle is given dynamics with the In the following 
example a tag name is assigned and three analog value ranges are created: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 

"VBA112 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 

Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 


"'NewDynamicl'") 

With objDynDialog 

-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.Add 50, 40 
-AnalogResultInfos.Add 100, 80 
-AnalogResultInfos.ElseCase = 100 
End With 

End Sub 


The diagram shows the Dynamic dialog after the procedure has been carried out: 
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See also 


Dynamic yalue ranges 


— name s 
. 


Expression/Formula 


‘NewDynamict Lil 


Result of the Expression/Formula 
; Data Type 


Valid range ue Posit... © Analog 
Value Rangel 50 40 © Boolean 
Value Range2 100 «80 OBit 
Other 100 O Direct 


Add... 


Remove 


© Do not evaluate tag status 
O Tag status © Quality Code 


DynamicDialog Object (Page 1955) 

AnalogResultInfos Object (Listing) (Page 1908) 

CreateDynamic Method (Page 1828) 

How to dynamize a property with the Dynamic dialog (Page 1691) 


Add Method (CustomToolbars Listing) 


Description 


syntax 


1788 


Creates a new, user-defined toolbar. There is a difference between application-specific and 
picture-specific user-defined toolbars: 


e Application-specific toolbar: This is linked to the Graphics Designer and is also only visible 
when all the pictures in the Graphics Designer are closed. "Place the VBA code in the 
document called "GlobalTemplateDocument" or "ProjectTemplateDocument" and use the 
Application property. 


e Picture-specific toolbar: Is linked with a specific picture and remains visible as long as the 
picture is visible. Place the VBA code in the document called "ThisDocument" for the desired 
picture and use the ActiveDocument property. 


Expression.Add (Key) 


Expression 


Necessary. An expression or element which returns an object of the "CustomToolbars" type. 
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Parameters 
Parameter (Data Type) 
Key (Variant) Identifies the user-defined toolbar. Use unique 
names for "Key" (e.g. "DocToolbar1") 
Example: 


In the following example a user-defined toolbar with two icons is created in the active picture. 
These icons are separated by a dividing line: 


Sub AddDocumentSpecificCustomToolbar () 
"VBA115 

Dim objToolbar As HMIToolbar 

Dim objToolbarItem As HMIToolbarItem 


Set objToolbar = ActiveDocument.CustomToolbars.Add("DocToolbar") 


"Add toolbar-items to the userdefined toolbar 

Set objToolbarItem = objToolbar.ToolbarItems.InsertToolbarItem(1, "tIteml_ 1", "My first 
Symbol-Icon") 
Set objToolbarItem = objToolbar.ToolbarItems.InsertToolbarItem(3, "tIteml 3", "My second 
Symbol-Icon") 


‘Insert seperatorline between the two tollbaritems 
Set objToolbarItem = objToolbar.ToolbarItems.InsertSeparator (2, "tSeparatorl 2") 
End Sub 


H Graphics Designer - [NewPdl1.PDL] 


fy Elle Edit View Insert Arrange Tools Window Help 


QaoBle |X alNelalva 


® Arial vv ah) 4M 


First symbol-icon |iusesese toe Medan ocean? 


See also 
Toolbars Object (Listing) (Page 2081) 
InsertToolbarltem Method (Page 1856) 
InsertSeparator Method (Page 1853) 
InsertFromMenultem Method (Page 1848) 
VBA Reference (Page 1745) 
Creating Customized Menus and Toolbars (Page 1627) 
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Add Method (Documents Listing) 


Description 
Creates a new picture in the Graphics Designer 
syntax 
Expression.Add [HMIOpenDocumentType] 
Expression 
Necessary. An expression or element which returns an object of the "Documents" type. 
Parameters 
Parameter (Data Type) Description 
HMlOpenDocumentType (HMIDocumentType) Defines how the picture will be opened: 

e HMIDocumentTypeVisible: Opens the picture 
for direct processing. This is the default setting 
if you do not specify the parameter. 

e HMIDocumentTypelnvisible: Opens the 
picture in invisible mode, i.e. it is not displayed 
in the Graphics Designer. You can only 
address the picture via the Documents listing, 
and make it visible again by means of the Hide 
property. 

Example: 


In the following example a new picture is created in the Graphics Designer: 


Sub AddNewDocument () 

'VBA113 

Application.Documents.Add hmiOpenDocumentTypeVisibl 
End Sub 


See also 
Hide Property (Page 2270) 
Documents Object (Listing) (Page 1952) 
VBA Reference (Page 1745) 
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Add Method (GroupedObjects Listing) 


Description 

Adds an existing object to the specified group object. 
syntax 

Expression.Add (Index) 

Expression 

Necessary. An expression or element which returns an object of the "GroupedObjects" type. 
Parameters 

Parameter (Data Type) Description 

Index (Variant) The object that is intended to be added. You can 


either use the index number or the object name. 
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Example: 


In this example the group object "My Group" is created from a number of objects. An ellipse 
segment is then added to the group object: 


Sub CreateGroup () 
'VBA114 
Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 

Dim objEllipseSegment As HMIE1llipseSegment 
Dim objGroup As HMIGroup 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SsRectangle", "HMIRectangle") 
With objCircle 

-Top = 40 

-Left = 40 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 80 

-Selected = Tru 

End With 


sgBox "Objects selected!" 
Set objGroup = ActiveDocument.Selection.CreateGroup 


"Set name for new group-object 
'The name identifies the group-object 
objGroup.ObjectName = "My Group" 


"Add new object to active document... 

Set objEllipseSegment = ActiveDocument.HMIObjects.AddHMIObject ("EllipseSegment", 
"HMIELlipseSegment") 

Set objGroup = ActiveDocument.HMIObjects ("My Group") 


',..and add it to the group: 
objGroup.GroupedHMIObjects.Add ("EllipseSegment") 
End Sub 


See also 
GroupedObjects Object (Listing) (Page 1983) 


Add Method (TagTriggers Listing) 


Description 


Creates a new tag trigger. 
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syntax 
Expression.Add (VarName, Type) 
Expression 
Necessary. An expression or element which returns an object of the "TagTriggers" type. 
Parameters 
Parameter (Data Type) Description 
VarName (String) The name of the tag that is intended to be used as 
a trigger. Please note that you have to create the 
tag in the Tag Selection dialog. 
Type (CycleType) This is the cycle type. Select the cycle type from a 
list in the VBA Editor when you use this method. 
Example: 


In the following example the radius of a circle is made dynamic using a trigger tag: 


Sub DynamicWithVariableTriggerCycle() 

"VBA69 

Dim objVBScript As HMIScriptInfo 

Dim objVarTrigger As HMIVariableTrigger 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument .HMIObjects.AddHMIObject ("Circle VariableTrigger", 
"HMICircle") 

Set objVBScript = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeVBScript) 
With objVBScript 

Set objVarTrigger = .Trigger.VariableTriggers.Add("VarTrigger", hmiVariableCycleType 10s) 
-SourceCode = "™ 

End With 

End Sub 


See also 
VariableTriggers Object (Listing) (Page 2101) 
VBA Reference (Page 1745) 


Add Method (Views Listing) 


Description 


Creates a copy of the specified picture. 
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syntax 

Expression.Add () 

Expression 

Necessary. An expression or element which returns an object of the "Views" type. 
Parameters 
Example: 


In the following example a copy of the active picture is created and then activated: 


Sub CreateViewAndActivateView() 

"VBA117 

Dim objView As HMIView 

Set objView = ActiveDocument.Views.Add 
objView.Activate 

End Sub 


See also 
Views Object (Listing) (Page 2103) 
VBA Reference (Page 1745) 


AddAction Method 


Description 


Configures an action on an object or property. This action is triggered when a defined event 
occurs. 


syntax 
Expression Method (HMIActionCreationType) 


Expression 
Necessary. An expression or element which returns an object of the "Actions" type. 
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Parameters 


Parameter (Data Type) Description 
HMlActionCreationType (Variant) Defines the action: 


e@ hmiActionCreationTypeCScript: Configures a 
C action 

e@ hmiActionCreationTypeVBScript: Configures 
a VBS action 


e@ hmiActionCreationTypeDirectConnection: 
Configures a direct connection 


Example: 


In the following example a VBS action for changing the radius of a circle is configured: 


Sub AddActionToPropertyTypeVBScript () 

'VBA118 

Dim objEvent As HMIEvent 

Dim objVBScript As HMIScriptInfo 

Dim objCircle As HMICircle 

"Create circle in picture. By changing of property "Radius" 

"a VBS-action will be started: 

Set objCircle = ActiveDocument .HMIObjects.AddHMIObject ("Circle AB", "HMICircle") 
Set objEvent = objCircle.Radius.Events (1) 

Set objVBScript = objEvent.Actions.AddAction (hmiActionCreationTypeVBScript) 
End Sub 


See also 
Event Object (Page 1966) 
Actions Object (Listing) (Page 1898) 


AddActiveXControl Method 


Description 


Adds a new ActiveXControl object to the "HMIlObjects" listing. The object is inserted in the 
upper left corner of the specified picture. 


syntax 


Expression.AddActiveXControl ("ObjectName", "ProgID") 


Expression 


Required. An expression or element which returns an object of the "HMlObjects" type. 
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Parameter 


Parameter (data type) 
ObjectName (String) 


Description 


The name of the object. You can address the object by its name ina 
listing. 
The ActiveX Control that is to be inserted. 


ProgID (String) 


Determining the ProgID 


To determine the ProgID for an ActiveX control, go to the "Object Palette" in the Graphics 
Designer and in the Default tab under "Smart Objects" insert the control object into the picture. 
The "Insert a Control" dialog displays the path and ProgID for the selected control: 


Insert a Control 
WinCC Alarm Control (Classic a 


WinCC AlarmControl 
WinCC Channel Diagnosis Control 

WinCC DataGridControl 
WinCC Digital/Analog Clock Control 

WinCC Dmc Control 

WinCC Function Trend Control (Classic) 

WinCC FunctionTrendControl 

WinCC Gauge Control 

WinCC ITagSet2 MasterCtrl 

WinCC Media Control 

WinCC NavigationBarControl 

WinCC Online Table Control (Classic) 

WinCC Online Trend Control (Classic) 


C:\Program Files\Common Files \Siemens \bin \CCAlgWinCtrl.ocx 
CCAlgWinCtrl.CCAlgWinCtrl.2 


— 


wax 


h Selection 
+)-u@ Standard Objects 
=|) Smart Objects 
QR Application Window 
{7] Picture Window 
OC} Control 
| OLE Element 
I/O Field 
= Bar 
£4) Graphic Object 
Status Display 
Text List 
Multiple row text 
Combobox 
List box 
Faceplate instance 
‘ze, NET Control 


4) Group Display 
+). Windows Objects 
#}~, Tube objects 


p AD standard | 


Controls | == 


The following table shows a list of ProgIDs of WinCC controls that are installed by WinCC: 


Name of the WinCC control 
Siemens HMI Symbol Library 


ProgID 
SiemensHMI.SymbolLibrary.1 


WinCC AlarmControl 


CCAxAlarmControl.AxAlarmControl.1 


WinCC digital/analog clock control 


DACLOCK.DaclockCtrl.1 


WinCC FunctionTrendControl 


CCAxFunctionTrendControl.AxFunctionTrendControl.1 


WinCC gauge control 


XGAUGE.XGaugeCtrl.1 


WinCC media control 


CCMediaControl.CCMediaControl.1 


WinCC OnlineTableControl 


CCAxOnlineTableControl.AxOnlineTableControl.1 


WinCC OnlineTrendControl 
WinCC push button control 


CCAxOnlineTrendControl.AxOnlineTrendControl.1 
PBUTTON.PbuttonCtrl. 1 
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Name of the WinCC control ProgID 

WinCC slider control SLIDER.SliderCtrl.1 

WinCC RulerControl CCAxTrendRulerControl.AxRulerControl. 1 
WinCC UserArchiveControl CCAxUserArchiveControl.AxUserArchiveControl.1 


Example: 


In the following example, the ActiveX Control "WinCC Gauge Control" is inserted in the active 
picture. 


Sub AddActiveXControl () 

'VBA119 

Dim objActiveXControl As HMIActiveXControl 

Set objActiveXControl = ActiveDocument.HMIObjects.AddActivexXControl ("WinCC_ Gauge", 
"XGAUGE. XGaugeCtr1l.1") 

With ActiveDocument 

-HMIObjects ("WinCC_Gauge") .Top = 40 

-HMIObjects ("WinCC_ Gauge") .Left = 40 


End With 

End Sub 
Note 
After executing the method, the Graphics Designer will not be fully shut down. The 
"Grafexe.exe" file remains in the memory. In order to restart the Graphics Designer, exit the 
"Grafexe.exe" application in the Task Manager. 

See also 


ActiveX controls (Page 1671) 
HMlObjects Object (Listing) (Page 1990) 
ActiveXControl Object (Page 1900) 
VBA Reference (Page 1745) 


AddDotNetControl method 


Description 
Adds a new ".Net-Control" object to the "HMIObjects" listing. 


Syntax 


Expression.AddDotNetControl (ObjectName, ControlType, InGAC, 
AssemblyInfo) 
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Expression 


Necessary. An expression or element which returns an object of the "HMlObjects" type. 


Parameters 
Parameter (Data Type) | Description 
ObjectName (String) The name of the object. You can address the object by its name in a listing. 
ControlType (String) The namespace of the object. 
InGAC (String) TRUE: The object is registered in the Global Assembly Cache. 
FALSE: The object is not registered in the Global Assembly Cache. 
AssemblyInfo (String) If "INGAC=TRUE", then the following information will be specified: 
Assembly 
Version 
Culture 
PublicKeyToken 
If "INGAC=FALSE", only the path of the object is specified in "Assembly". 
Example 
In the following example, the ".NETControl" object from the Global Assembly Cache is inserted 
in the active picture. 
"VBA851 


Dim DotNetControl As HMIDotNetControl 

Set DotNetControl = ActiveDocument.HMIObjects.AddDotNetControl ("MyVBAControl", 
"System.Windows.Forms.Label", True,"Assembly=System.Windows.Forms, Version=2.0.0.0, 
Culture=neutral, PublicKeyToken=b77a5c561934e089") 


AddFolder Method 


Description 


Creates a new folder in the components library. The Folderltem object of the "Folder" type is 
added to the Folderltems listing. 


The new folder created in this way receives the internal name "FolderX", where "X" stands for 
a consecutive number, starting with 1. Use the internal name to address the folder in the 


Folderltems listing. 


syntax 


Expression.AddFolder(DefaultName) 
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Expression 
Necessary. An expression or element which returns an object of the "Folderltems" type. 


Parameter (Data Type) Description 
DefaultName (String) The name of the folder that is to be created. 


In the following example the folder "My Folder" will be created in the "Project Library": 


Sub AddNewFolderToProjectLibrary () 


'VBA120 
Dim objProject 


Lib As HMISymbolLibrary 


Set objProjectl 


End Sub 


See also 


Lib = Application.SymbolLibraries (2) 


objProjectLib.FolderItems.AddFolder ("My Folder") 


SymbolLibrary Object (Page 2074) 

Folderltems Object (Listing) (Page 1973) 

VBA Reference (Page 1745) 

Accessing the component library with VBA (Page 1646) 


AddFromClipboard Method 


Description 


syntax 


Copies an object from the clipboard into a folder in the Components Library. The Folderltem 
object of the "Item" type is added to the Folderltems listing. 


Note 


The clipboard must contain objects from the Graphics Designer. Other contents (such as ASCII 
text) will not be pasted. 


Expression.AddFromClipboard (DefaultName) 
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Expression 
Necessary. An expression or element which returns an object of the "Folderltems" type. 


Parameters 
Parameter (Data Type) Description 
DefaultName (String) The name to be given to the object pasted into the 
components library. 
Example: 


In the following example the object "PC" from the "Global Library" will be copied into the folder 
"Folder 3" in the "Project Library": 


Sub CopyObjectFromGlobalLibraryToProjectLibrary () 
"VBA121 

Dim objGlobalLib As HMISymbolLibrary 

Dim objProjectLib As HMISymbolLibrary 

Set objGlobalLib = Application.SymbolLibraries (1) 
Set objProjectLib = Application.SymbolLibraries (2) 
obj ProjectLib.FolderItems.AddFolder ("My Folder3") 


‘copy object from "Global Library" to clipboard 

With objGlobalLib 

.-FolderItems (2) .Folder.Item(2) .Folder.Item(1) .CopyToClipboard 
End With 


"paste object from clipboard into "Project Library" 
objProjectLib. FolderItems (obj ProjectLib. FindByDisplayName ("My 
Folder3") .Name) .Folder.AddFromClipBoard ("Copy of PC/PLC") 
End Sub 


See also 
Folderltems Object (Listing) (Page 1973) 
SymbolLibrary Object (Page 2074) 
VBA Reference (Page 1745) 
Accessing the component library with VBA (Page 1646) 
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AddHMlObject Method 


Description 


Adds a new standard, smart or Windows object to the "HMIObjects" listing. The object is 
inserted in the upper left corner of the specified picture. 


Note 
Use the AddActiveXControl method to insert an ActiveXControl. 
Use the AddOLEObject method to insert an OLE Element. 


syntax 
Expression.AddHMIObject ("ObjectName", "ProgID") 
Expression 
Necessary. An expression or element which returns an object of the "HMlObjects" type. 
Parameters 
Parameter (Data Type) Description 
ObjectName (String) The name of the object. You can address the ob- 
ject by its name in a listing. 
ProgID (String) The object type that is to be inserted. "Obtain the 
"ProgID" by prefixing the VBA object name with 
"HMI" "(e.g. HMICircle or HMIRectangle) 
Example: 


In the following example a circle will be inserted into the active picture and its background color 
set to "Red": 


Sub AddCircleToActiveDocument () 


"VBA122 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("VBA Circle", "HMICircle") 
objCircle.BackColor = RGB(255, 0, 0) 

End Sub 

See also 


PieSegment Object (Page 2032) 
TextList Object (Page 2076) 
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StatusDisplay Object (Page 2070) 
StaticText Object (Page 2067) 

Slider object (Page 2062) 
RoundRectangle Object (Page 2055) 
RoundButton Object (Page 2052) 
Rectangle Object (Page 2049) 
PolyLine Object (Page 2038) 
PictureWindow Object (Page 2029) 
OptionGroup Object (Page 2025) 
HMlObjects Object (Listing) (Page 1990) 
Line Object (Page 2004) 

IOField Object (Page 1992) 
GraphicObject Object (Page 1975) 
EllipseArc Object (Page 1960) 
EllipseSegment Object (Page 1963) 
Ellipse Object (Page 1957) 

CircularArc Object (Page 1931) 

Circle Object (Page 1928) 

CheckBox Object (Page 1924) 

Button Object (Page 1921) 

BarGraph Object (Page 1914) 
ApplicationWindow Object (Page 1911) 
AddOLEObject Method (Page 1803) 
AddActiveXControl Method (Page 1795) 
VBA Reference (Page 1745) 


Addlitem Method 

Description 
Copies an object from the specified picture into a folder in the Components Library. The 
Folderltem object of the "Item" type is added to the Folderltems listing. 

syntax 


Expression.Folder.AddItem "DefaultName", pHMIObject 
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Expression 
Necessary. An expression or element which returns an object of the "Folderltems" type. 


Parameters 
Parameter (Data Type) Description 
DefaultName (String) The name to be given to the object pasted into the 
components library. 
pHM|Object (HMIObject) The object that is to be inserted into the Compo- 
nents Library from the specified picture. 
Example: 
In the following example a circle will be copied into the "Project Library". For this purpose the 
circle will be pasted into the active picture and the folder "My Folder 2" will 
Sub VBA123 () 
'VBA123 


Dim objProjectLib As HMISymbolLibrary 
Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle", "HMICircle") 

Set objProjectLib = Application.SymbolLibraries (2) 

obj ProjectLib.FolderItems.AddFolder ("My Folder2") 
objProjectLib.FindByDisplayName ("My Folder2") .Folder.AddItem "ProjectLib Circle", 
ActiveDocument.HMIObjects ("Circle") 


End Sub 
See also 
Folderltems Object (Listing) (Page 1973) 
SymbolLibrary Object (Page 2074) 
VBA Reference (Page 1745) 
Accessing the component library with VBA (Page 1646) 
AddOLEObject Method 
Description 


Adds a new OLE Element to the "HMlObjects" listing. The object is inserted in the upper left 
corner of the specified picture. 
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syntax 


[UseSymbol1] ) 


Expression 


Expression.AddOLEObject (ObjectName, ServerName, [CreationTypel, 


Necessary. An expression or element which returns an object of the "HMlObjects" type. 


Parameters 


Parameter (Data Type) 


Description 


ObjectName (String) 


The name of the object. You can address the object by its name in a listing. 


ServerName (String) 


The name of the application which is to contain the OLE Element, or the file 
name complete with path. The value for "ServerName" corresponds to the 
"Object Type" in the "Insert Object" dialog: 


Insertar objeto Ee 


= 
@ Crear nuevo Adobe Acrobat Document —————____—____—— 
CcCiss Class Cancelar | 
7 i ControlHost .Document 
Ean ie aces Documento de Wordpad 
Imagen de Paintbrush 
"ServerName" Paquete 


Mostrar como icono 


Resultado 
Inserta un nuevo objeto Documento de Wordpad 


en su documento. 


CreationType (HMIO- 
LEObjectCreationType-) 


Defines whether the OLE Element will be newly created or an existing file 

will be used: 

@ HMIOLEObjectCreationTypeDirect: Corresponds to setting "Create 
New". This setting is used if you do not specify the parameter. 


e@ HMIOLEObjectCreationTypeByLink: Corresponds to setting "Create 
from File". This creates a copy of the file. Any changes made to the OLE 
Element have no effect on the original file. Assign a name to the file via 
the "ServerName" parameter. 


e HMIOLEObjectCreationTypeByLinkWithReference: Same as above, 


except that changes in OLE Element affect the original file. Assign a 
name to the file via the "ServerName" parameter. 


UseSymbol (Boolean) 


TRUE if the standard icon for the file type is to be used. Double clicking on 
the icon then opens the associated application. The default setting for this 
parameter is FALSE. 
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Example: 


In the following example, an OLE Element containing a Wordpad document will be inserted 
into the active picture: 


Sub AddOLEObjectToActiveDocument () 
"VBA124 
Dim objJOLEObject As HMIOLEObject 

Set objOLEObject = ActiveDocument.HMIObjects.AddOLEObject ("MS Wordpad Document", 
"Wordpad.Document.1") 

End Sub 


In the following example, the AddOLEObject method will be used and the 
"HMIOLEObjectCreationTypeByLink" parameter will be specified: 


Sub AddOLEObjectByLink () 
"VBA805 
Dim objOLEObject As HMIOLEObject 


Dim strFilename As String 
' 


‘Add OLEObject by filename. In this case, the filename has to 

"contain filename and path. 

"Replace the definition of strFilename with a filename with path 

‘existing on your system 

strFilename = Application.ApplicationDataPath & "Test.bmp" 

Set objOLEObject = ActiveDocument.HMIObjects.AddOLEObject ("OLEObject1l", strFilename, 
hmiOLEObjectCreationTypeByLink, False) 

End Sub 


In the following example, the AddOLEObject method will be used and the 
"HMIOLEObjectCreationTypeByLinkWithReference" parameter will be specified: 


Sub AddOLEObjectByLinkWithRe ference () 
"VBA806 
Dim objJOLEObject As HMIOLEObject 


Dim strFilename As String 
' 


"Add OLEObject by filename. In this case, the filename has to 

"contain filename and path. 

"Replace the definition of strFilename with a filename with path 

‘existing on your system 

strFilename = Application.ApplicationDataPath & "Test.bmp" 

Set objOLEObject = ActiveDocument.HMIObjects.AddOLEObject ("OLEObject1", strFilename, 
hmiOLEObjectCreationTypeByLinkWithReference, True) 

End Sub 
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See also 
OLEObject Object (Page 2023) 
HM|Objects Object (Listing) (Page 1990) 
VBA Reference (Page 1745) 


AddWPFControl method 


Description 
Adds a new "WPF-Control" object to the "HMIObjects" listing. 
Syntax 
Expression.AddWPFControl (ObjectName, ControlType, InGAC, 
AssemblyInfo) 
Expression 
Necessary. An expression or element which returns an object of the "HMlObjects" type. 
Parameters 
Parameter (Data Type) | Description 
ObjectName (String) The name of the object. You can address the object by its name in a listing. 
ControlType (String) The namespace of the object. 
InGAC (String) TRUE: The object is registered in the Global Assembly Cache. 
FALSE: The object is not registered in the Global Assembly Cache. 
AssemblyInfo (String) If "INGAC=TRUE", then the following information will be specified: 
Assembly 
Version 
Culture 
PublicKeyToken 
If "INGAC=FALSE", only the path of the object is specified in "Assembly". 
Example 
In the following example, the "WPF Control" object outside the Global Assembly Cache is 
inserted in the active picture. 
"VBA852 


Dim WPFControl As HMIWPFControl 
Set WPFControl = ActiveDocument.HMIObjects.AddWPFControl ("MyWPFVBAControl", 
"WinCCWPFControl.TestControl", False, "Assembly=Z:\TestControl\WinCCWPFControl.dll") 
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AlignBottom Method 


Description 
Aligns the objects selected in the specified picture with In so doing the alignment is oriented 
on the first object that you select. 
syntax 
Expression.AlignBottom () 
Expression 
Necessary. An expression or element which returns an object of the "Selection" type. 
Parameters 
Example: 


In the following example two objects are inserted at different positions in the current picture 
and then aligned with the bottom: 


Sub AlignSelectedObjectsBottom () 
"'VBA125 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SRectangle", "HMIRectangle") 
With objCircle 

-Top = 40 

-Left = 40 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 80 

-Selected = Tru 

End With 


sgBox "Objects selected!" 
ActiveDocument.Selection.AlignBottom 
End Sub 


See also 
SelectedObjects object (Listing) (Page 2060) 
VBA Reference (Page 1745) 
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AlignLeft Method 


Description 
Left-justifies the objects selected in the specified picture. In so doing the alignment is oriented 
on the first object that you select. 
syntax 
Expression.Alignleft () 
Expression 
Necessary. An expression or element which returns an object of the "Selection" type. 
Parameters 
Example: 


In the following example two objects are inserted at different positions in the current picture 
and then aligned to the left: 


Sub AlignSelectedObjectsLeft () 
"VBA126 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SRectangle", "HMIRectangle") 
With objCircle 

-Top = 40 

-Left = 40 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 80 

-Selected = Tru 

End With 


sgBox "Objects selected!" 
ActiveDocument.Selection.AlignLeft 
End Sub 


See also 
SelectedObjects object (Listing) (Page 2060) 
VBA Reference (Page 1745) 
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AlignRight Method 


Description 
Right-justifies the objects selected in the specified picture. In so doing the alignment is oriented 
on the first object that you select. 
syntax 
Expression.AlignRight () 
Expression 
Necessary. An expression or element which returns an object of the "Selection" type. 
Parameters 
Example: 


In the following example two objects are inserted at different positions in the current picture 
and then aligned to the right: 


Sub AlignSelectedObjectsRight () 
'VBA127 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SRectangle", "HMIRectangle") 
With objCircle 

-Top = 40 

-Left = 40 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 80 

-Selected = Tru 

End With 


sgBox "Objects selected!" 
ActiveDocument.Selection.AlignRight 
End Sub 


See also 
SelectedObjects object (Listing) (Page 2060) 
VBA Reference (Page 1745) 
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AlignTop Method 


Description 
Aligns the objects selected in the specified picture with In so doing the alignment is oriented 
on the first object that you select. 
syntax 
Expression.AlignTop () 
Expression 
Necessary. An expression or element which returns an object of the "Selection" type. 
Parameters 
Example: 


In the following example two objects are inserted at different positions in the current picture 
and then aligned with the top: 


Sub AlignSelectedObjectsTop () 
"VBA128 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SRectangle", "HMIRectangle") 
With objCircle 

-Top = 40 

-Left = 40 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 80 

-Selected = Tru 

End With 


sgBox "Objects selected!" 
ActiveDocument.Selection.AlignTop 
End Sub 


See also 
SelectedObjects object (Listing) (Page 2060) 
VBA Reference (Page 1745) 
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ArrangeMinimizedWindows Method 


Description 


syntax 


Parameters 


Example: 


Arranges all minimized pictures on the lower margin of the Graphics Designer. 


Expression.ArrangeMinimizedWindows () 


Expression 


Necessary. An expression or element which returns an object of the "Application" type. 


In the following example all minimized pictures are arranged on the lower margin of the 
Graphics Designer. For this example to work, you must have minimized a number of pictures 
in the Graphics Designer: 


Sub ArrangeMinimizedWindows () 


"VBA129 


Application. ArrangeMinimizedWindows 


End Sub 


See also 


Application Object (Page 1909) 
VBA Reference (Page 1745) 


BackwardOneLevel Method 


Description 


syntax 


Moves the selected objects one level backward within their current layer. 


Expression.BackwardOneLeveli () 
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Expression 


Necessary. An expression or element which returns an object of the "Selection" type. 


Parameters 


Example: 


In the following example two objects are inserted in the active picture. The object inserted last 


is then moved backward one level: 


Sub MoveObjectOneLevelBackward () 
'VBA173 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SsRectangle", "HMIRectangle") 


With objCircle 

-Top = 40 

-Left = 40 

-Selected = Fals 

End With 

With objRectangle 

-Top = 40 

-Left = 40 

-Width = 100 

-Height = 50 

-BackColor = RGB(255, 0, 255) 
-Selected = Tru 

End With 

sgBox "Objects created and selected!" 
ActiveDocument.Selection.BackwardOneLevel 
End Sub 


See also 
SelectedObjects object (Listing) (Page 2060) 
VBA Reference (Page 1745) 
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BringToFront Method 


Description 


Brings the selected objects right to the front within their current layer. 


Note 


If the "BringToFront" method is used, the sequence of HMI objects can change in the 
HMlObjects listing. 


Syntax 

Expression. BringToFront () 

Expression 

Necessary. An expression or element which returns an object of the "Selection" type. 
Parameters 
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Example: 


In the following example two objects are inserted in the active picture. The object inserted last 
is then brought to the front: 


Sub MoveObjectToFront () 

'VBA198 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SsRectangle", "HMIRectangle") 
With objCircle 

-Top = 40 

-Left = 40 

-Selected = Tru 

End With 

With objRectangle 

-Top = 40 

-Left = 40 

-Width = 100 

-Height = 50 

-BackColor = RGB(255, 0, 255) 

-Selected = Fals 

End With 

sgBox "The objects circle and rectangle are created" & vbCrLf & "Only the circle is 
selected!" 

ActiveDocument.Selection.BringToFront 

sgBox "The selection is moved to the front." 


End Sub 
See also 
SelectedObjects object (Listing) (Page 2060) 
VBA Reference (Page 1745) 
CascadeWindows Method 
Description 
Arranges all open pictures in the Graphics Designer in a cascade (i.e. overlapping). 
syntax 


Expression.Methode (Parameter) 


Expression 
Necessary. An expression or element which returns an object of the "Application" type. 
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Parameters 


Example: 


In the following example all open pictures in the Graphics Designer are arranged in a cascade. 
For this example to work, you must have opened a number of pictures in the Graphics Designer: 


Sub CascadeWindows () 
'VBA130 
Application.CascadeWindows 
End Sub 


See also 
VBA Reference (Page 1745) 
Application Object (Page 1909) 


CenterHorizontally Method 


Description 

Using this method, the objects selected in the specified picture are centered horizontally. 
syntax 

Expression.CenterHorizontally() 

Expression 

Necessary. An expression or element which returns an object of the "Selection" type. 
Parameters 
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Example: 


In the following example two objects are inserted at different positions in the current picture 
and then centered horizontally: 


Sub CenterSelectedObjectsHorizontally() 
'VBA131 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SsRectangle", "HMIRectangle") 
With objCircle 

-Top = 40 

-Left = 40 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 80 

-Selected = Tru 

End With 


sgBox "Objects selected!" 
ActiveDocument.Selection.CenterHorizontally 
End Sub 


See also 
SelectedObjects object (Listing) (Page 2060) 
VBA Reference (Page 1745) 


CenterVertically Method 


Description 

Using this method, the objects selected in the specified picture are centered vertically. 
syntax 

Expression.CenterVertically() 

Expression 

Necessary. An expression or element which returns an object of the "Selection" type. 
Parameters 
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Example: 
In the following example two objects are inserted at different positions in the current picture 
and then centered vertically: 


Sub CenterSelectedObjectsVertically() 
'VBA132 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "“HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SsRectangle", "HMIRectangle") 
With objCircle 

-Top = 40 

-Left = 40 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 80 

-Selected = Tru 

End With 


sgBox "Objects selected!" 
ActiveDocument.Selection.CenterVertically 


End Sub 
See also 
SelectedObjects object (Listing) (Page 2060) 
VBA Reference (Page 1745) 
CheckSyntax Method 
Description 
Checks whether the syntax of the specified C script is correct. 
Use the CheckSyntax method in conjunction with the Compiled Property. 
syntax 


Expression.CheckSyntax (CheckOK, Error) 


Expression 
Necessary. An expression or element which returns an object of the "DynamicDialog" type. 
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Parameters 


Example: 


See also 


Close Method 


Description 


Syntax 1 


Syntax 2 


Parameters 
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Parameter (Data Type) Description 

CheckOK (Boolean) TRUE if the syntax of the specified C script is cor- 
rect. 

Error (String) The message text that is output if the C script is 
incorrect. 


DynamicDialog Object (Page 1955) 
VBA Reference (Page 1745) 


Closes the specified picture and removes it from the document listing. 


Note 


Changes that have not been saved will be lost. 


Expression.Close (FileName) 


Expression 


Necessary. An expression or element which returns an object of the "Documents" type. 


Expression.Close () 


Expression 
Necessary. An expression or element which returns an object of the "Document" type. 


Parameter (Data Type) Description 


FileName (String) The name of the PDL file to be closed. 
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Example: 


In the following example the picture "Test.PDL" will For this example to work, you must have 
opened the picture "Test.PDL": 


Sub CloseDocumentUsingTheFileName () 

"VBA134 

Dim strFile As String 

strFile = Application.ApplicationDataPath & "test.pdl" 
Application.Documents.Close (strFile) 

End Sub 

In the following example the active picture in the Graphics Designer will be closed: 
Sub CloseDocumentUsingActiveDocument () 

"VBA135 

ActiveDocument.Close 

End Sub 


See also 
Document Object (Page 1949) 
ActiveDocument Property (Page 2107) 
Documents Object (Listing) (Page 1952) 
VBA Reference (Page 1745) 


CloseAll Method 


Description 


Closes all the pictures opened in the Graphics Designer and removes them from the 
documents listing. 


Note 


Changes that have not been saved will be lost. 


syntax 


Expression.CloseA11 () 


Expression 


Necessary. An expression or element which returns an object of the "Documents" type. 


Parameters 
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Example: 
In the following example all open pictures in the Graphics Designer are closed: 


Sub CloseAllDocuments () 


'VBA136 
Application.Documents.CloseAll 
End Sub 
See also 
Documents Object (Listing) (Page 1952) 
VBA Reference (Page 1745) 
ConvertToScript Method 
Description 
Converts the specified Dynamic dialog into a C script. 
On conversion the associated DynamicDialog object is deleted. 
Note 
You cannot undo the conversion. 
syntax 
Expression.ConvertToScript () 
Expression 
Necessary. An expression or element which returns an object of the "DynamicDialog" type. 
Parameters 
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Example: 


In the following example a circle will be inserted into the active picture and its radius will be 
dynamically configured using the Dynamic dialog. The Dynamic dialog will then be converted 
into a C script. 


Sub ConvertDynamicDialogToScript () 

'VBA137 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 


"Create dynamic 


Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 


""NewDynamicl'") 
' 


‘configure dynamic. "ResultType" defines the valuerange-typ 
With objDynDialog 

-ResultType = hmiResultTypeAnalog 

-AnalogResultInfos.Add 50, 40 

-AnalogResultInfos.Add 100, 80 

-AnalogResultInfos.ElseCase = 100 

sgBox "The dynamic-dialog will be changed into a C-script." 
-ConvertToScript 

End With 

End Sub 


See also 
DynamicDialog Object (Page 1955) 
VBA Reference (Page 1745) 


ConvertToVBScript method 


Description 
Converts the specified Dynamic dialog into a VB script. 
On conversion, the associated DynamicDialog object is deleted. 
Note 
You cannot undo the conversion. 
Syntax 


Expression.ConvertTovBScript () 
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Expression 
Required. An expression which returns an object of the "DynamicDialog" type. 


Parameters 


Example 


In the following example, a circle is inserted into the active picture and its radius is dynamically 
configured using the Dynamic dialog. The Dynamic dialog is then converted into a VB script. 


Sub ConvertDynamicDialogToVBScript () 

'VBA908 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 


"Create dynamic 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 


"'NewDynamicl'") 
' 


"configure dynamic. "ResultType" defines the valuerange-typ 
With objDynDialog 

-ResultType = hmiResultTypeAnalog 

-AnalogResultInfos.Add 50, 40 

-AnalogResultInfos.Add 100, 80 

-AnalogResultInfos.ElseCase = 100 

sgBox "The dynamic-dialog will be changed into a VB-script." 
-ConvertToVBScript 

End With 

End Sub 


See also 
DynamicDialog Object (Page 1955) 


ConvertWM method 


Description 


Is used internally for PowerCC. 
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CopySelection Method 


Description 
Using this method, the objects selected in the picture are copied to the clipboard. 
syntax 
Expression.CopySelection () 
Expression 
Necessary. An expression or element which returns an object of the "Document" or "Selection" 
type. 
Parameters 
Example: 


In the following example two of the objects inserted in the active picture are selected. The 
selection is copied and pasted to a new picture: 


Sub CopySelectionToNewDocument () 
"'VBA138 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 
Dim iNewDoc As Integer 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SRectangle", "HMIRectangle") 
With objCircle 

-Top = 40 

-Left = 40 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 80 

-Selected = Tru 

End With 


sgBox "Objects selected!" 

"Instead of "ActiveDocument.CopySelection" you can also write: 
'ActiveDocument.Selection.CopySelection". 
ActiveDocument.CopySelection 

Application.Documents.Add hmiOpenDocumentTypeVisibl 

iNewDoc = Application.Documents.Count 
Application.Documents (iNewDoc) .PasteClipboard 

End Sub 
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See also 
Document Object (Page 1949) 
ActiveDocument Property (Page 2107) 
SelectedObjects object (Listing) (Page 2060) 
PasteClipboard Method (Page 1868) 
Add Method (Documents Listing) (Page 1790) 
Activate Method (Page 1785) 
VBA Reference (Page 1745) 


CopyToClipboard Method 


Description 

Copies an object from a folder in the Components Library to the clipboard. 
Syntax 

Expression.CopyToClipboard() 

Expression 

Necessary. An expression or element which returns a Folderltem object of the "Item" type. 
Parameters 
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In the following example the object "PC" from the "Global Library" will be copied into the folder 


"My Folder3" in the "Project Library": 


Sub CopyObjectFromGlobalLibraryToProjectLibrary () 
'VBA139 

Dim objGlobalLib As HMISymbolLibrary 

Dim objProjectLib As HMISymbolLibrary 

Dim objFolderItem As HMIFolderItem 


Set objGlobalLib = Application.SymbolLibraries (1) 

Set objProjectLib = Application.SymbolLibraries (2) 
objProjectLib.FolderItems.AddFolder ("My Folder3") 

' 

‘copy object from "Global Library" to clipboard 

With objGlobalLib 

.-FolderItems (2) .Folder.Item(2) .Folder.Item(1) .CopyToClipboard 
End With 


"paste object from clipboard into "Project Library" 
Set objFolderItem = objProjectLib.FindByDisplayName ("My Folder3") 
objFolderItem.Folder.AddFromClipBoard ("Copy of PC/PLC") 


End Sub 


See also 
SymbolLibrary Object (Page 2074) 
Folderltem Object (Page 1972) 
VBA Reference (Page 1745) 
Accessing the component library with VBA (Page 1646) 


CreateCustomizedObject Method 


Description 
Creates a customized object from the objects selected in the specified picture. You then have 
to configure the customized object in the "Configuration Dialog". 
For further information on this topic please refer to "Customized Objects" in this documentation 
and "Customized Object" in the WinCC documentation. 

syntax 


Expression.CreateCustomizedObject () 
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Expression 
Necessary. An expression or element which returns an object of the "Selection" type. 


Parameters 


Example: 


In the following example two objects are inserted at different positions in the current picture 
and a customized object is then created: 


Sub CreateCustomizedObject () 

'VBA140 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 

Dim objCustObject As HMICustomizedObject 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SRectangle", "HMIRectangle") 
With objCircle 

-Top = 40 

-Left = 40 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 80 

-Selected = Tru 

End With 


sgBox "Objects selected!" 

Set objCustObject = ActiveDocument.Selection.CreateCustomizedObject 
objCustObject.ObjectName = "myCustomizedObject" 

End Sub 


See also 
SelectedObjects object (Listing) (Page 2060) 
CustomizedObject Object (Page 1938) 
VBA Reference (Page 1745) 
Customized Objects (Page 1682) 
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CreateDynamicDialog method 


Description 
Dynamizing properties of pictures and objects depending on specific value ranges or variable 
statuses. 
Syntax 
Expression.CreateDynamicDialog([Code as String],iResultType as Long) 
Expression 
Required. An expression or element which returns an object of the "Property" type. 
Parameter 
Parameter (Data Type) Description 
Code (String) Defines the function or tag that is used for dynamic 
purposes. Also specify the tag name in single quo- 
tation marks: "Tag name" 
iResultType (Long) Defines the type of value range: 
@ hmiResultTypeDirect = 0 
e@ hmiResultTypeAnalog= 1 
@ hmiResultTypeBool = 2 
@ hmiResultTypeBit = 3 
Example 


In the following example the radius of a circle is given dynamics with the dynamic dialog. A 
tag name and a "ResultType" are assigned to the dynamic dialog. 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 

"VBA820 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 

"Create Object 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("myCircle", "HMICircle") 
"Create dynamic (Tag "myTest" must be exist") 

Set objDynDialog = objCircle.Radius.CreateDynamicDialog("'myTest'",1) 

End Sub 


See also 
FaceplateProperty object (Page 1971) 
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CreateDynamic Method 


Description 
Makes the specified property dynamic. 


syntax 

Expression.cCreateDynamic(DynamicType, [SourceCode] ) 

Expression 

Necessary. An expression or element which returns an object of the "Property" type. 
Parameters 


You only need use the "SourceCode" parameter if you want to make the specified property 
dynamic with the aid of the Dynamic dialog. 


In all other types of dynamics you can omit the parameter. 


Parameter (Data Type) Description 


DynamicType (HMIDynamicCreationType) Defines the type of dynamics: 


@ hmiDynamicCreationTypeVariableDirect: 
Dynamics with a tag 


@ hmiDynamicCreationTypeVariablelndirect: 
Dynamics with a tag In this type of dynamics 
you specify only the name of the tag whose 
value will be used for dynamic purposes. 


e hmiDynamicCreationTypeScript: Dynamics 
with a script (C, VB). 

@ hmiDynamicCreationTypeDynamicDialog: 
Dynamizing with the dynamic dialog box: 


SourceCode (String) Defines the function or tag that will be used for 
dynamic purposes. 

Also specify the tag name in single quote marks: 
"Tag name" 
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Example: 


In this example a circle property "Top" will be made dynamic with the aid of the tag 
"NewDynamic": 


Sub AddDynamicAsVariableDirectToProperty () 

"VBA141 

Dim objVariableTrigger As HMIVariableTrigger 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("MyCircle", "HMICircle") 

"Make property "Top" dynamic: 

Set objVariableTrigger = objCircle.Top.CreateDynamic (hmiDynamicCreationTypeVariableDirect, 


"NewDynamic") 
' 


"Define cycle-tim 
With objVariableTrigger 


.CycleType = hmiCycleType 2s 


End With 
End Sub 
See also 
Property Object (Page 2042) 
DeleteDynamic Method (Page 1833) 
VBA Reference (Page 1745) 
CreateGroup Method 
Description 
Creates a group object from the objects selected in the specified picture. 
For further information on this topic please refer to "Group Objects" in this documentation and 
"Group Object" in the WinCC documentation. 
syntax 
Expression.CreateGroup () 
Expression 
Necessary. An expression or element which returns an object of the "Selection" type. 
Parameters 
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Example: 


In the following example two objects are inserted at different positions in the current picture 


and a group object is then created: 


Sub CreateGroup () 

"'VBA142 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 
Dim objGroup As HMIGroup 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "“HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SRectangle", "HMIRectangle") 
With objCircle 

-Top = 40 

-Left = 40 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 80 

-Selected = Tru 

End With 


sgBox "Objects selected!" 

Set objGroup = ActiveDocument.Selection.CreateGroup 
objGroup.ObjectName = "myGroup" 

End Sub 


See also 
SelectedObjects object (Listing) (Page 2060) 
Group Object (Page 1978) 
VBA Reference (Page 1745) 
Group Objects (Page 1674) 


D-M 


GetDeclutterObjectSize method 


Description 


Reads the limits displaying and hiding objects (decluttering) in the specified picture. 


Syntax 


Expression.GetDeclutterObjectSize (Min, Max) 
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Expression 


Required. An expression or element which returns an object of the "Document" type. 


Parameter 
Parameter (data type) Description 
Min (Long) Lower size range in pixels. 
Max (Long) Upper size range in pixels. 
Example 


In the following example, the decluttering limits of the active picture are read and output: 


Sub ReadSettingsOfPicture() 


"VBA848 


Dim objectsize min As Long, objectsize max As Long 


End Sub 


Delete Method 


Description 


ActiveDocument .GetDeclutterObjectSize objectsize min, objectsize max 
sgBox objectsize min & " " & objectsize max 


Deletes the specified object and removes it from the listing. 


syntax 


Expression.Delete () 


Expression 


Necessary. An expression or element which returns objects of the following types. 


Assignment 
Folderltem 
LanguageText 
Menu 
Menultem 
Object 


Toolbar 
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e Toolbarltem 
e VariableTrigger 


e View 


Parameters 


Example: 


In the following example the first object in the active picture will be deleted. For this example 
to work, you must have created at least one object in the active picture: 


Sub ObjectDelete () 

'VBA143 

ActiveDocument .HMIObjects (1) .Delete 
End Sub 


See also 
LanguageText Object (Page 1999) 
View Object (Page 2102) 
VariableTrigger Object (Page 2099) 
Toolbarltem Object (Page 2083) 
Folderltem Object (Page 1972) 
HM|Object Object (Page 1988) 
Menultem Object (Page 2013) 
Menu Object (Page 2009) 
VBA Reference (Page 1745) 


DeleteAll Method 


Description 


Deletes all selected objects in the specified picture and removes them from the "Selection" 
and "HMlObjects" listings. 


syntax 
Expression.DeleteA11 () 
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Expression 
Necessary. An expression or element which returns an object of the "Selection" type. 


Parameters 


Example: 


In the following example two objects are inserted at different positions in the current picture 
and then selected and deleted: 


Sub DeleteAllSelectedObjects () 
"VBA145 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "“HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SRectangle", "HMIRectangle") 
With objCircle 

-Top = 40 

-Left = 40 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 80 

-Selected = Tru 

End With 


sgBox "Objects selected!" 
ActiveDocument.Selection.DeleteAll 


End Sub 
See also 
SelectedObjects object (Listing) (Page 2060) 
VBA Reference (Page 1745) 
DeleteDynamic Method 
Description 
Removes the dynamic characteristic from the specified property. 
syntax 


Expression.DeleteDynamic 
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Expression 
Necessary. An expression or element which returns an object of the "Property" type. 


Parameters 


Example: 


In the following example the dynamic characteristic created with the aid of the CreateDynamic 
Method will be 


Sub DeleteDynamicFromObjectMeinkreis () 


"VBA146 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument.HMIObjects("MyCircle") 
objCircle.Top.DeleteDynamic 

End Sub 

See also 


Property Object (Page 2042) 
CreateDynamic Method (Page 1828) 
VBA Reference (Page 1745) 


DeselectAll Method 


Description 
Deselects all selected objects in the specified picture and removes them from the Selection 
listing. 
syntax 
Expression.DeselectAl11 () 
Expression 
Necessary. An expression or element which returns an object of the "Selection" type. 
Parameters 
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Example: 


In the following example two objects are inserted at different positions in the current picture 
and selected. All selected objects are then deselected: 


Sub SelectObjectsAndDeselectThemAgain () 
"'VBA147 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "“HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SsRectangle", "HMIRectangle") 
With objCircle 

-Top = 40 

-Left = 40 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 80 

-Selected = Tru 

End With 


sgBox "Objects created and selected!" 
ActiveDocument.Selection.DeselectAll 
sgBox "Objects deselected!" 


End Sub 
See also 

SelectedObjects object (Listing) (Page 2060) 

VBA Reference (Page 1745) 
Destroy Method 
Description 

Ungroups the specified customized object. The objects remain intact. 
Syntax 

Expression.Destroy () 

Expression 

An expression or element which returns objects of the "CustomizedObject" types. 
Parameters 
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Example: 


See also 


An example showing how to use the Destroy Method can be found in this documentation under 
the heading "Editing a Customized Object with VBA". 


CustomizedObject Object (Page 1938) 

Destroy Method (Page 1835) 

Delete Method (Page 1831) 

CreateCustomizedObject Method (Page 1825) 

How to Edit a Customized Object with VBA (Page 1683) 


DuplicateSelection Method 


Description 


syntax 


Parameters 


1836 


Duplicates the objects selected in the specified picture. The objects created in this way are 
added to the HMlObjects listing. The names of new objects are numbered consecutively with 
each duplication. 


For instance if you duplicate an object called "Circle", the duplicate object is called "Circle1". 
If you duplicate the object called "Circle" once more, the resulting object is called "Circle2" and 
so on. 


Expression.DuplicateSelection() 


Expression 
Necessary. An expression or element which returns an object of the "Selection" type. 
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Example: 


In the following example two objects are inserted at different positions in the current picture 
and selected. They are then duplicated: 


Sub DuplicateSelectedoObjects () 
"VBA149 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SsRectangle", "HMIRectangle") 
With objCircle 

-Top = 40 

-Left = 40 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 80 

-Selected = Tru 

End With 


sgBox "Objects created and selected!" 
ActiveDocument.Selection.DuplicateSelection 
End Sub 


See also 
SelectedObjects object (Listing) (Page 2060) 
HMlObjects Object (Listing) (Page 1990) 
VBA Reference (Page 1745) 


EvenlySpaceHorizontally Method 


Description 


Using this method, the objects selected in the specified picture are spaced horizontally at an 
even distance from one another. 


syntax 


Expression.EvenlySpaceHorizontally() 


Expression 
Necessary. An expression or element which returns an object of the "Selection" type. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 1837 


VBA for Automated Configuration 
3.6 VBA Reference 


Parameters 


Example: 


In the following example three objects are inserted at different positions in the current picture 
and selected. They are then positioned horizontally at an even distance from one another: 


Sub EvenlySpaceObjectsHorizontally () 

'VBA150 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 

Dim objEllipse As HMIEllipse 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SsRectangle", "HMIRectangle") 
Set objEllipse = ActiveDocument.HMIObjects.AddHMIObject ("SEllipse", "HMIEllipse") 
With objCircle 

-Top = 30 

-Left = 0 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 42 

-Selected = Tru 

End With 

With objEllipse 

-Top = 48 

-Left = 162 

-BackColor = RGB(255, 0, O) 

-Selected = Tru 

End With 

sgBox "Objects created and selected!" 
ActiveDocument.Selection.EvenlySpaceHorizontally 
End Sub 


See also 
VBA Reference (Page 1745) 
SelectedObjects object (Listing) (Page 2060) 


EvenlySpaceVertically Method 


Description 


Using this method, the objects selected in the specified picture are spaced vertically at an even 
distance from one another. 
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syntax 
Expression.EvenlySpaceVertically() 
Expression 
Necessary. An expression or element which returns an object of the "Selection" type. 
Parameters 
Example: 
In the following example three objects are inserted at different positions in the current picture 
and selected. They are then positioned vertically at an even distance from one another: 
Sub EvenlySpaceObjectsVertically() 
"VBAL51 
Dim objCircle As HMICircle 
Dim objRectangle As HMIRectangle 
Dim objEllipse As HMIEllipse 
Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "“HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SRectangle", "HMIRectangle") 
Set objEllipse = ActiveDocument.HMIObjects.AddHMIObject ("SEllipse", "HMIEllipse") 
With objCircle 
-Top = 30 
-Left = 0 
-Selected = Tru 
End With 
With objRectangle 
-Top = 80 
-Left = 42 
-Selected = Tru 
End With 
With objEllipse 
-Top = 48 
-Left = 162 


-BackColor = RGB(255, 0, O) 
-Selected = Tru 


End 


End 


With 


sgBox "Objects created and selected" 
ActiveDocument.Selection.! 


Sub 


See also 


SelectedObjects object (Listing) (Page 2060) 
VBA Reference (Page 1745) 
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Export Method 
Description 
Saves the specified picture as an EMF file. 
Syntax 
Expression.Export (Type, Path) 
Expression 
Required. An expression or element which returns an object of the "Document" type. 
Parameter 
Parameter (Data Type) Description 
Type (HMIlmportExportType) Defines the format in which the exported picture 
will be saved. 
Path (String) The path in which the picture is going to be expor- 
ted. The path must exist. 
Example 
Sub ExportAllPicturesAsPDL() 
"VBA152 
Dim iPictureCounter As Integer 
Dim strPath As String 
strPath = "C:\WinCC_PDL Export\" 
"Count Pictures in Graphics Designer... 
For iPictureCounter = 1 To grafexe.Documents.Count 
",..and export each picture as PDL-file to specified path: 
grafexe.Documents (iPictureCounter) .Export hmiImportExportTypePDL, 
strPath 
ext iPictureCounter 
End Sub 
See also 
View Object (Page 2102) 
Document Object (Page 1949) 
WinCC: Scripting (VBS, ANSI-C, VBA) 
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Find Method 


Description 


syntax 


Parameters 


3.6 VBA Reference 


Searches for objects in the specified picture and returns the search result as a collection object. 
You can search for the following object properties: 


e Type 
e Name 


e Property 


Expression.Find(([ObjectType], [ObjectName], [PropertyName] ) 


Expression 
Necessary. An expression or element which returns an object of the "HMIlObjects" type. 


You must specify at least one of the three parameters. 


Parameter (Data Type) Description 


ObjectType (String) The object type that is to be searched for. Specify 
the "ProgID" of the object concerned. "Obtain the 
"ProgID" by prefixing the VBA object name with 
"HMI" "(e.g. HMICircle or HMIRectangle) 


ObjectName (String) The name of the object that is to be searched for. 
You can use placeholders (?,*) in the object name 
in order to find objects with similar names. 


PropertyName (String) The name of the object property that is to be 
searched for. Specify the VBA property name con- 
cerned (e.g. "BackColor" in place of "Background 
Color"). 
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Example: 


In the following example, objects of the "HM|ICircle" type will be searched for in the active 
picture and the search result will be output: 


Sub FindObjectsByType () 

"VBA153 

Dim colSearchResults As HMICollection 

Dim objMember As HMIObject 

Dim iResult As Integer 

Dim strName As String 

Set colSearchResults = ActiveDocument.HMIObjects.Find(ObjectType:="HMICircle") 
For Each objMember In colSearchResults 

iResult = colSearchResults.Count 

strName = objMember.ObjectNam 

sgBox "Found: " & CStr(iResult) & vbCrLf & "objectname: " & strName) 
Next objMember 

End Sub 


Note 


Further information on using the Find Method can be found in this documentation under the 
heading "Editing Standard Objects, Smart Objects and Windows Objects". 


See also 
Type Property (Page 2450) 
Name Property (Page 2343) 
Property Object (Page 2042) 
HM|Objects Object (Listing) (Page 1990) 
How to edit Default objects, Smart objects, Windows objects and Tube objects (Page 1664) 
VBA Reference (Page 1745) 


FindByDisplayName Method 


Description 


Searches the entire Components Library for the specified object. A Folderltem object is 
returned as the search result. 


Note 


The display name of the object is language-dependent. Only the language currently set will 
be taken into account when searching. The search ends with the first object found. 
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syntax 


Parameters 


Example: 


3.6 VBA Reference 


Expression.FindByDisplayName (DisplayName) 


Expression 


Necessary. An expression or element which returns an object of the "SymbolLibrary" type or 
the "Folderltems" listing. 


Parameter (Data Type) Description 


DisplayName (String) The display name of the object that is to be 
searched for in the Components Library. 


In the following example the entire library will be searched for the object "PC" and its display 
name will be output: 


Sub FindObjectInSymbolLibrary () 


"VBA154 
Dim objGloball 


Lib As HMISymbolLibrary 


Dim objFItem As HMIFolderItem 


Set objGloball 


End Sub 


See also 


Lib = Application.SymbolLibraries (1) 


Set objFItem = objGlobalLib.FindByDisplayName ("PC") 
sgBox objFItem. DisplayName 


Folderltem Object (Page 1972) 
Accessing the component library with VBA (Page 1646) 


FireConnectionEvents method 


Description 


FlipHorizontally 


Description 


Is used internally by the Graphics Designer. 


Method 


Mirrors the selected objects in the specified picture along the horizontal midline. 
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The object type determines whether it is allowed to be mirrored (for instance an OLE Element 
cannot be mirrored). The properties are appropriately modified when mirroring is performed. 
For example, if you mirror an object of the "StaticText" type along the horizontal midline, the 
value of the "AlignmentTop" property changes from "0" to "2". 


syntax 

Expression.FlipHorizontally() 

Expression 

Necessary. An expression or element which returns an object of the "Selection" type. 
Parameters 
Example: 


In the following example a StaticText object will be inserted into the active picture and mirrored 
along the horizontal midline: 


Sub FlipObjectHorizontally () 

"VBA155 

Dim objStaticText As HMIStaticText 

Dim strPropertyName As String 

Dim iPropertyValue As Integer 

Set objStaticText = ActiveDocument.HMIObjects.AddHMIObject ("Textfield", "HMIStaticText") 
strPropertyName = objStaticText. Properties ("Text") .Name 

With objStaticText 

-Width = 120 


-Text = "Sample Text" 

-Selected = Tru 

iPropertyValue = .AlignmentTop 

sgBox "Value of '" & strPropertyName & "' before flip: " & iPropertyValue 


ActiveDocument.Selection.FlipHorizontally 

iPropertyValue = objStaticText.AlignmentTop 

sgBox "Value of '" & strPropertyName & "' after flip: " & iPropertyValue 
End With 

End Sub 


See also 
SelectedObjects object (Listing) (Page 2060) 
VBA Reference (Page 1745) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
1844 System Manual, 02/2016, ASE37536061-AA 


VBA for Automated Configuration 
3.6 VBA Reference 


FlipVertically Method 


Description 
Mirrors the selected objects in the specified picture along the vertical midline. 
The object type determines whether it is allowed to be mirrored (for instance an OLE Element 
cannot be mirrored). The properties are appropriately modified when mirroring is performed. 
For example if you mirror an object of the "StaticText" type along the vertical midline, the value 
of the "AlignmentLeft" property changes from "0" to "2". 
syntax 
Expression.FlipVertically() 
Expression 
Necessary. An expression or element which returns an object of the "Selection" type. 
Parameters 
Example: 


In the following example a StaticText object will be inserted into the active picture and mirrored 
along the vertical midline: 


Sub FlipObjectVertically () 

"VBA1L56 

Dim objStaticText As HMIStaticText 

Dim strPropertyName As String 

Dim iPropertyValue As Integer 

Set objStaticText = ActiveDocument.HMIObjects.AddHMIObject ("Textfield", "HMIStaticText") 
strPropertyName = objStaticText. Properties ("Text") .Name 

With objStaticText 

-Width = 120 

-Text = "Sample Text" 

-Selected = Tru 

-AlignmentLeft = 0 

iPropertyValue = .AlignmentLeft 

sgBox "Value of '" & strPropertyName & "' before flip: " & iPropertyValue 
ActiveDocument.Selection.FlipVertically 

iPropertyValue = objStaticText.AlignmentLeft 

sgBox "Value of '" & strPropertyName & "' after flip: " & iPropertyValue 
End With 

End Sub 
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See also 
SelectedObjects object (Listing) (Page 2060) 
VBA Reference (Page 1745) 


ForwardOneLevel Method 


Description 
Moves the selected objects one level forward within their current layer. 
syntax 
Expression.ForwardOneLevel () 
Expression 
Necessary. An expression or element which returns an object of the "Selection" type. 
Parameters 
Example: 


In the following example two objects are inserted in the active picture. The object inserted first 
is then moved forward one level: 


Sub MoveObjectOneLevelForward() 

"VBA174 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "HMICircle") 

Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SsRectangle", "HMIRectangle") 
With objCircle 

-Top = 40 

-Left = 40 

-Selected = Tru 

End With 

With objRectangle 

-Top = 40 

-Left = 40 

-Width = 100 

-Height = 50 

-BackColor = RGB(255, 0, 255) 
-Selected = Fals 

End With 

sgBox "Objects created and selected!" 
ActiveDocument.Selection.ForwardOneLevel 
End Sub 
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See also 
SelectedObjects object (Listing) (Page 2060) 
VBA Reference (Page 1745) 


GetltemByPath Method 


Description 
Returns a Folderltem object (folder or object) located on the specified internal access path in 
the Components Library. 
Note 
To obtain the internal access path, select the "Copy Path" command from The internal access 
path to the folder or object will then be copied to the clipboard. 
syntax 
Expression.Get ItemByPath (PathName) 
Expression 
Necessary. An expression or element which returns an object of the "SymbolLibrary" type. 
Parameters 
Parameter (Data Type) Description 
PathName (String) The internal access path on which the object is 
located in the Components Library. 
Example: 


In this example one object from the entire library will be returned and its display name will be 
output: 


Sub ShowDisplayName () 

"VBAL57 

Dim objGlobalLib As HMISymbolLibrary 

Dim objFItem As HMIFolderItem 

Set objGlobalLib = Application.SymbolLibraries (1) 

Set objFItem = objGlobalLib.GetItemByPath("\Folderl\Folder2\Object1") 
sgBox objFItem. DisplayName 

End Sub 
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See also 


SymbolLibrary Object (Page 2074) 
Folderltem Object (Page 1972) 


Accessing the component library with VBA (Page 1646) 


InsertFromMenultem Method 


Description 
Inserts into an existing, user-defined toolbar a new icon that references an existing menu entry 
in a user-defined menu. 
Use this method if you wish to set up a toolbar so that it contains the same commands as an 
existing user-defined menu. 
Syntax 
Expression.InsertFromMenulItem(Position, Key, pMenulItem, 
DefaultToolTipText) 
Expression 
Required. An expression or element which returns an object of the "Toolbarltems" type. 
Parameters 

Parameter (Data Type) Description 

Position (Long) Defines the position of the icon within the user-de- 
fined toolbar. 

Key (Variant) Identifies the symbol. Use unique names for "Key" 
"(e.g. tltem1_1). 

pMenultem (HMIMenultem) The Menultem object that is intended to be refer- 
enced. 

DefaultToolTipText (String) Defines for the icon concerned the tool tip text that 
will be displayed when you move the mouse over 
the icon. 
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Example: 


In this example a user-defined menu and a user-defined toolbar will be inserted in the active 
picture. The icon calls up the menu entry "Hello World" from the user-defined menu: 


Sub ToolbarItem_InsertFromMenultem () 
"VBA158 
Dim objMenu As HMIMenu 

Dim objToolbarItem As HMIToolbarItem 

Dim objToolbar As HMIToolbar 

Dim objMenuItem As HMIMenulItem 

Set objMenu = Application.CustomMenus.InsertMenu(1, "Menul", "TestMenu") 


KKK KK KK KKKKKKKKKKKKKK KK KK KKK KKKKKKKKKKKKKKK KKK KKK 


'* Note: 


'* The object-reference has to be unique. 
VK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKKKKKKK KK KK 


Set objMenuItem = Application.CustomMenus (1) .MenuItems.InsertMenulItem(1, "MenuIteml", 
"Hello World") 

Application.CustomMenus (1) .MenuItems(1).Macro = "HelloWorld" 

Set objToolbar = Application.CustomToolbars.Add("Toolbarl") 

Set objToolbarItem = Application.CustomToolbars(1).ToolbarItems.InsertFromMenuItem(1, 
"ToolbarItem1", objMenulItem, "Call's Hello World of TestMenu") 

End Sub 


Sub HelloWorld() 
sgBox "Procedure 'HelloWorld()' is execute." 
End Sub 


See also 
Toolbarltems Object (Listing) (Page 2085) 
InsertSeparator Method (Page 1853) 
Add Method (CustomToolbars Listing) (Page 1788) 
VBA Reference (Page 1745) 
Creating Customized Menus and Toolbars (Page 1627) 
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InsertWenu Method 


Description 


syntax 


Parameters 


1850 


Creates a new, user-defined menu. There is a difference between application-specific and 


picture-specific user-defined menus: 


e Application-specific menu: This is linked to the Graphics Designer and is also only visible 
when all the pictures in the Graphics Designer are closed. "Place the VBA code in the 
document called "GlobalTemplateDocument" or "ProjectTemplateDocument" and use the 


Application property. 


e Picture-specific menu: Is linked with a specific picture and remains visible as long as the 
picture is visible. Place the VBA code in the document called "ThisDocument" for the desired 
picture and use the ActiveDocument property. 


Expression.InsertMenu (Position, Key, 


Expression 


DefaultLabel) 


Necessary. An expression or element which returns an object of the "CustomMenus" type. 


Parameter (Data Type) 


Position (Long) 


Description 


Defines the position of the user-defined menu with- 
in the menu bar. However, picture-specific menus 
are always positioned to the right of application- 
specific menus. 


Key (Variant) 


Identifies the user-defined menu. Use unique 
names for "Key" (e.g. "DocMenu1") 


DefaultLabel (String) 


The name of the user-defined menu. 
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Example: 


3.6 VBA Reference 


In the following example, a user-defined menu with two menus entries and a submenu with 
two entries will be created in the active picture. The submenu will be visually distinguished by 


a dividing line: 


Sub CreateDocumentMenus () 


"VBA159 


Dim objDocMenu As HMIMenu 
Dim objMenuItem As HMIMenuItem 
Dim objSubMenu As HMIMenuItem 


Set objDocMenu 


= ActiveDocument.CustomMenus.InsertMenu(1, "DocMenul", "Doc Menu_1") 


oe et 


‘Insert a dividing rule into custumized menu: 


objMenultem = objDocMenu.MenuItems.InsertMenulItem(1, "dmIteml_ 1", "First Menultem") 
objMenultem = objDocMenu.MenuItems.InsertMenulItem(2, "dmIteml 2", "Second MenulItem") 


Set objMenultem = objDocMenu.Menultems.InsertSeparator (3, "dSeparatorl 3") 


Set objSubMenu 


Set objMenuItem = objSubMenu.SubMenu.InsertMenulItem(5, 


= objDocMenu.MenuItems.InsertSubMenu(4, "dSubMenul 4", "First SubMenu") 


menu") 


Set objMenuItem = objSubMenu.SubMenu.InsertMenulItem(6, 


menu") 
End Sub 


See also 


The diagram shows the generated menu structure. 


First Menultem “ + Ai, = ay £ ag wy 
Second Menultem SS 


Second item in sub-menu 


Menus Object (Listing) (Page 2011) 

InsertSubmenu Method (Page 1854) 

InsertSeparator Method (Page 1853) 

InsertMenultem Method (Page 1852) 

VBA Reference (Page 1745) 

Creating Customized Menus and Toolbars (Page 1627) 
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InsertWMenultem Method 


Description 
Inserts a new entry in a user-defined menu. 
syntax 
Expression.InsertMenultem(Position, Key, DefaultLabel) 
Expression 
Necessary. An expression or element which returns an object of the "Menultems" type. 
Parameters 
Parameter (Data Type) Description 
Position (Long) Defines the position of the submenu within the 
user-defined menu. 
Key (Variant) Identifies the submenu. Use unique names for 
"Key" "(e.g. dSubMenu1_4). 
DefaultLabel (String) Defines the name of the submenu. 
Example: 


In the following example, a user-defined menu with two menus entries and a submenu with 
two entries will be created in the active picture. The submenu will be visually distinguished by 
a dividing line: 


Sub CreateDocumentMenus () 
'VBA160 

Dim objDocMenu As HMIMenu 

Dim objMenuItem As HMIMenuItem 
Dim objSubMenu As HMIMenuItem 


Set objDocMenu = ActiveDocument.CustomMenus.InsertMenu(1, "DocMenul", "Doc Menu_1") 


objMenultem = objDocMenu.MenulItems.InsertMenulItem(1, "dmIteml_ 1", "First Menultem") 
objMenultem = objDocMenu.Menultems.InsertMenultem(2, "dmIteml 2", "Second MenulItem") 


"Insert a dividing rule into customized menu: 
Set objMenuItem = objDocMenu.Menultems.InsertSeparator (3, "dSeparatorl 3") 


Set objSubMenu = objDocMenu.MenulItems.InsertSubMenu(4, "dSubMenul 4", "First SubMenu") 


Set objMenultem = objSubMenu.SubMenu.InsertMenultem(5, "dmIteml 5", "First item in sub- 
menu") 

Set objMenultem = objSubMenu.SubMenu.InsertMenultem(6, "dmIteml 6", "Second item in sub- 
menu") 

End Sub 
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See also 


3.6 VBA Reference 


The diagram shows the menu structure. 
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Menultems Object (Listing) (Page 2015) 

Menultem Object (Page 2013) 

InsertSubmenu Method (Page 1854) 

InsertSeparator Method (Page 1853) 

InsertMenu Method (Page 1850) 

VBA Reference (Page 1745) 

Creating Customized Menus and Toolbars (Page 1627) 


InsertSeparator Method 


Description 


syntax 


Parameters 


Inserts a dividing line in a user-defined menu or user-defined toolbar. 


Expression.InsertSeparator (Position, Key) 


Expression 


Necessary. An expression or element which returns an object of the "Menultems" or 
"Toolbarltems" type. 


Parameter (Data Type) Description 


Position (Long) Defines the position of the dividing line within the 
user-defined menu or user-defined toolbar. 


Key (Variant) Identifies the dividing line. Use unique names for 
"Key" (e.g. "tSeparator1_2"). 
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Example: 


In the following example a user-defined toolbar with two icons is created in the active picture. 
These icons are separated by a dividing line: 


Sub AddDocumentSpecificCustomToolbar () 

'VBA161 

Dim objToolbar As HMIToolbar 

Dim objToolbarItem As HMIToolbarItem 

Set objToolbar = ActiveDocument.CustomToolbars.Add("DocToolbar") 

‘Add toolbar-item to userdefined toolbar 

Set objToolbariItem = objToolbar.ToolbarItems.InsertToolbarItem(1, "tIteml_ 1", "First 
symbol-icon") 
Set objToolbariItem = objToolbar.ToolbarItems.InsertToolbarItem(3, "tIteml_ 3", "Second 


symbol-icon") 
' 


"Insert dividing rule between first and second symbol-icon 


Set objToolbariItem = objToolbar.ToolbarItems.InsertSeparator (2, "tSeparatorl 2") 
End Sub 


See also 
Toolbarltems Object (Listing) (Page 2085) 
Menultems Object (Listing) (Page 2015) 
InsertToolbarltem Method (Page 1856) 
VBA Reference (Page 1745) 
Creating Customized Menus and Toolbars (Page 1627) 


InsertSubmenu Method 


Description 


Inserts a submenu into an existing user-defined menu. 


syntax 
Expression.InsertSubmenu (Position, Key, DefaultLabel) 


Expression 


Necessary. An expression or element which returns an object of the "Menultem" type 
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Parameters 


Example: 


Parameter (Data Type) 
Position (Long) 


3.6 VBA Reference 


Description 


Defines the position of the submenu within the 
user-defined menu. 


Key (Variant) 


Identifies the submenu. Use unique names for 
"Key" "(e.g. dSubMenu1_4). 


DefaultLabel (String) 


Defines the name of the submenu. 


In the following example, a user-defined menu with two menus entries and a submenu with 
two entries will be created in the active picture. The submenu will be visually distinguished by 


a dividing line: 


Sub CreateDocumentMenus () 


"VBA162 


Dim objDocMenu As HMIMenu 
Dim objMenuItem As HMIMenuItem 
Dim objSubMenu As HMIMenuItem 


Set objDocMenu = ActiveDocum 


cr ot 


objMenuItem = objDocMenu 


objMenultem = objDocMenu 


‘Insert a dividing rule into customized menu: 


Set objMenuItem = objDocMenu 
Set objSubMenu 


Set objMenuItem = objSubMenu.SubMenu.InsertMenulItem(5, 


= objDocMenu.MenulItems. InsertSubMenu (4, 


menu") 


Set objMenuItem = objSubMenu.SubMenu.InsertMenulItem(6, 


menu") 
End Sub 


The diagram shows the menu structure: 
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See also 
Menultem Object (Page 2013) 
InsertSeparator Method (Page 1853) 
InsertMenultem Method (Page 1852) 
InsertMenu Method (Page 1850) 
VBA Reference (Page 1745) 
Creating Customized Menus and Toolbars (Page 1627) 


InsertToolbarltem Method 


Description 
Inserts a new icon in an existing user-defined toolbar. 
syntax 
Expression.InsertToolbarItem(Position, Key, DefaultToolTipText) 
Expression 
Necessary. An expression or element which returns an object of the "Toolbarltems" type. 
Parameters 
Parameter (Data Type) Description 
Position (Long) Defines the position of the icon within the user-de- 
fined toolbar. 
Key (Variant) Identifies the symbol. Use unique names for "Key" 
"(e.g. tltem1_1). 
DefaultToolTipText (String) Defines for the icon concerned the tool tip text that 
will be displayed when you move the mouse over 
the icon. 
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Example: 


In the following example a user-defined toolbar with two icons is created in the active picture. 
These icons are separated by a dividing line: 


Sub AddDocumentSpecificCustomToolbar () 

'VBA163 

Dim objToolbar As HMIToolbar 

Dim objToolbarItem As HMIToolbarItem 

Set objToolbar = ActiveDocument.CustomToolbars.Add("DocToolbar") 

‘Add toolbar-item to userdefined toolbar 

Set objToolbarItem = objToolbar.ToolbarItems.InsertToolbarItem(1, "tIteml_ 1", "First 
symbol-icon") 


Set objToolbarItem = objToolbar.ToolbarItems.InsertToolbarItem(3, "tIteml 3", "Second 
symbol-icon") 


‘Insert dividing rule between first and second symbol-icon 


Set objToolbariItem = objToolbar.ToolbarItems.InsertSeparator (2, "tSeparatorl 2") 
End Sub 


H Graphics Designer - [NewPdl1.PDL] 
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See also 
Toolbarltems Object (Listing) (Page 2085) 
InsertSeparator Method (Page 1853) 
Add Method (CustomToolbars Listing) (Page 1788) 
VBA Reference (Page 1745) 
Creating Customized Menus and Toolbars (Page 1627) 


IsCSLayerVisible Method 


Description 
Returns TRUE if the specified CS layer is visible. 


syntax 


Expression.IsCSLayerVisible (Index) 
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Expression 


Necessary. An expression or element which returns an object of the "Document" type. 


Parameters 
Parameter (Data Type) Description 
Index (Variant) Defines the CS layer. Value range from 1 to 32. 
Layer0 corresponds to the index value "1" 
Example: 


The following example determines whether CS layer 1 in the copy of the active picture is visible 


and outputs the result: 


Sub IsCSLayerVisible() 

'VBA164 

Dim objView As HMIView 

Dim strLayerName As String 

Dim iLayerIdx As Integer 

Set objView = ActiveDocument.Views (1) 
objView.Activate 

iLayerIdx = 2 


strLayerName = ActiveDocument.Layers (iLayerIdx) .Name 
If objView.IsCSLayerVisible(iLayerIdx) = True Then 
sgBox "CS " & strLayerName & " is visible" 

Else 
sgBox "CS " & strLayerName & " is invisible" 

End If 

End Sub 

See also 


Document Object (Page 1949) 
VBA Reference (Page 1745) 
Editing Layers with VBA (Page 1657) 


IsRTLayerVisible Method 


Description 


Returns TRUE if the specified RT layer is visible. 


syntax 


Expression.IsRTLayerVisible (Index) 
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Expression 
Necessary. An expression or element which returns an object of the "Document" type. 


Parameters 
Parameter (Data Type) Description 
Index (Variant) Defines the RT layer. Value range from 1 to 32. 
LayerO corresponds to the index value "1". 
Example: 


The following example determines whether RT layer 1 is visible and outputs the result: 


Sub RTLayerVisibility() 
'VBA165 

Dim strLayerName As String 
Dim iLayerIdx As Integer 
iLayerIdx = 2 


strLayerName = ActiveDocument.Layers (iLayerIdx) .Name 

If ActiveDocument.IsRTLayerVisible(iLayerIdx) = True Then 
sgBox "RT " & strLayerName & " is visible" 

Else 
sgBox "RT " & strLayerName & " is invisible" 

End If 

End Sub 

See also 


Document Object (Page 1949) 
VBA Reference (Page 1745) 
Editing Layers with VBA (Page 1657) 


Item Method 


Description 


Returns an element from a listing. 


syntax 


Expression.1 tem (Index) 


Expression 


Necessary. An expression or element which returns an object. 
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Parameters 


Parameter (Data Type) Description 


Index (Variant) The name or index number of an element from the 
listing. 

You can use the Object Name as the name. As the 
index number you can use a numerical expression 
(from 1 up to the value of the Count property of the 
listing). 

If the entered value fails to match any element in 
the listing, this counts as an error. 


Example: 


Note 


The Item Method is the default method for listings. Both the following examples give the same 
result. 


In the following example the name of the first picture in the Graphics Designer is output: 


Sub ShowDocumentNameLongVersion() 

"VBA166 

Dim strDocName As String 

strDocName = Application.Documents.Item(3) .Name 
sgBox strDocName 

End Sub 


Sub ShowDocumentNameShortVersion () 
'VBA167 
Dim strDocName As String 


strDocName = Application.Documents (3) .Name 
sgBox strDocName 
End Sub 


See also 
VariableStateValues Object (Listing) (Page 2097) 
Count Property (Page 2201) 
Views Object (Listing) (Page 2103) 
VariableTriggers Object (Listing) (Page 2101) 
Toolbarltems Object (Listing) (Page 2085) 
Toolbars Object (Listing) (Page 2081) 
SymbolLibraries Object (Listing) (Page 2073) 
SelectedObjects object (Listing) (Page 2060) 
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Properties Object (Listing) (Page 2041) 
HM|Objects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
Menultems Object (Listing) (Page 2015) 
Menus Object (Listing) (Page 2011) 

Layers Object (Listing) (Page 2003) 
LanguageTexts Object (Listing) (Page 2000) 
LanguageFonts Object (Listing) (Page 1997) 
GroupedObjects Object (Listing) (Page 1983) 
Folderltems Object (Listing) (Page 1973) 
Events Object (Listing) (Page 1967) 
Documents Object (Listing) (Page 1952) 
DataLanguages Object (Listing) (Page 1942) 
ConnectionPoints Object (Listing) (Page 1936) 
AnalogResultInfos Object (Listing) (Page 1908) 
Actions Object (Listing) (Page 1898) 

VBA Reference (Page 1745) 


ItemByLcid Method 


Description 


Syntax 


Selects the language for which you wish to enter the font settings. Read only access. 


Note 


You can only select languages in which you have already configured. 


Expression.ItemByLcid (LangID) 


Expression 
Required. An expression or element which returns an object of the "LanguageFonts" type. 
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Parameter 
Parameter (Data Type) 
LangID (Long) This is the language identifier. The list of language 
identifiers is contained, for example, in the "Lan- 
guages.csv" file that is found in the index of the 
WinCC documentation. 
Example 


The following example sets the font attributes of a button for French and English. In contrast 
to English, French is displayed on the button in a smaller font with a constant tracking (Courier 
New, 12pt): 


Sub ExampleForLanguageFonts () 

'VBA168 

Dim objLangFonts As HMILanguageFonts 

Dim objButton As HMIButton 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMIButton") 
objButton.Text = "Hello" 

Set objLangFonts = objButton.LDFonts 


'To make fontsettings for English: 
With objLangFonts.ItemByLCID (1033) 
-Family = "Times New Roman" 

-Bold = False 

-Italic = True 

.Underlined = Fals 

-Size = 14 

End With 


' 


'To make fontsettings for French: 


With objLangFonts.ItemByLCID (1036) 
-Family = "Courier New" 
-Bold = True 


-Italic = False 
-Underlined = Tru 
Size = 12 

End With 


End Sub 


See also 
LanguageFonts Object (Listing) (Page 1997) 
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LoadDefaultConfig Method 


Description 
Loads the file in which the default settings for objects are saved. The PDD file is located in the 
"GraCS" folder of the current project. 
syntax 
Expression.LoadDefaultConfig (FileName) 
Expression 
Necessary. An expression or element which returns an object of the "Application" type. 
Parameters 
Parameter (Data Type) Description 
FileName (String) The name of the PDD file which it is intended to 
load. 
Example: 


In the following example the file "Test.PDD" will be loaded. For this example to work, you must 
have previously saved the file. You can do this with the aid of the SaveDefaultConfig Method: 


Sub LoadDefaultConfig() 

"VBA169 

Application.LoadDefaultConfig ("Test.PDD") 
End Sub 


See also 
Application Object (Page 1909) 
SaveDefaultConfig Method (Page 1881) 
VBA Reference (Page 1745) 


MoveOneLayerDown Method 


Description 


Moves the selected object in the specified picture into the next lowest layer. 
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syntax 

Expression.MoveOneLayerDown () 

Expression 

Necessary. An expression or element which returns an object of the "Selection" type. 
Parameters 
Example: 


In the following example a circle in the active picture is inserted in the third layer and then 
moved to the next lowest layer: 


Sub MoveObjectOneLayerDown () 
'VBA170 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "“HMICircle") 
With objCircle 
-Top = 40 
-Left = 40 
-Selected = Tru 
.Layer = 3 
sgBox "Circle is inserted into layer" & Str(.Layer) 
ActiveDocument.Selection.MoveOneLayerDown 
sgBox "Circle is moved into layer" & Str(.Layer) 


End With 
End Sub 


See also 
SelectedObjects object (Listing) (Page 2060) 
VBA Reference (Page 1745) 


MoveOneLayerUp Method 


Description 
Moves the selected object in the specified picture into the next highest layer. 


syntax 
Expression MoveOneLayeruUp () 
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Parameters 


Example: 


Expression 


Necessary. An expression or element which returns an object of the "Selection" type. 


3.6 VBA Reference 


In the following example a circle in the active picture is inserted in the third layer and then 


moved to the next highest layer: 


Sub MoveObjectOneLayerUp () 


'VBA171 


Dim objCircle As HMICircle 
Dim objRectangle As HMIRectangle 


Set objCircl 
With objCircl 


= ActiveDocument.HMIObjects.AddHMIObject ("sCircle", 


e 


-Top = 40 

-Left = 40 
-Selected = Tru 
.Layer = 3 


sgBox "Circl 


End With 
End Sub 


See also 


sgBox "Circl 


le is inserted into layer" & Str(.Layer) 
ActiveDocument.Selection.MoveOneLayerUp 
le is moved into layer" & Str(.Layer) 


SelectedObjects object (Listing) (Page 2060) 


VBA Reference (Page 1745) 


MoveSelection Method 


Description 


syntax 


Moves one or more objects selected in the picture by the specified coordinates. 


"HMTCircle") 


Note 


When you want to reposition one or more selected objects, use the properties "Left" and "Top". 


Expression.MoveSelection (PosXx, 
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Expression 
Required. An expression or element which returns an object of the "Document" or "Selection" 
type. 
Parameters 
Parameter (Data Type) Description 
PosX (Long) The number of pixels by which the selection is to 
be moved horizontally. 
PosY (Long) The number of pixels by which the selection is to 
be moved vertically. 
Example: 


In the following example two objects are inserted at different positions in the current picture 
and selected. The selection is then moved 30 pixels to the right and 40 pixels down: 


Sub MoveSelectionToNewPostion() 
'VBA172 

Dim nPosX As Long 

Dim nPosY As Long 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SRectangle", "HMIRectangle") 
With objCircle 

-Top = 40 

-Left = 40 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 80 

-Selected = Tru 

End With 


sgBox "Objects selected!" 

nPosxX = 30 

nPosy = 40 

ActiveDocument .MoveSelection nPosX, nPosY 
End Sub 


See also 
Top Property (Page 2446) 
Left Property (Page 2305) 
Document Object (Page 1949) 
VBA Reference (Page 1745) 
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O-Z 


Open Method 


Description 
Opens an existing picture in the Graphics Designer and adds it to the documents listing. 


syntax 
Expression.Open (FileName, [HMIOpenDocumentType] ) 


Expression 
Necessary. An expression or element which returns an object of the "Documents" type. 


Parameters 


Parameter (Data Type) Description 
FileName (String) The name of the PDL file to be opened. 


Unless you saved the PDL file in the "GraCS" fold- 
er of the open project, you must also specify the 
path at the same time. 


HMlOpenDocumentType (HMIDocumentType) Defines how the picture will be opened: 


e HMIDocumentTypeVisible: Opens the picture 
for direct processing. This is the default setting 
if you do not specify the parameter. 


e HMIDocumentTypelnvisible: Opens the 
picture in invisible mode, i.e. it is not displayed 
in the Graphics Designer. You can only 
address the picture via the Documents listing, 
and make it visible again by means of the Hide 
property. 


Example: 


In the following example the picture "Test" will be opened. For this example to work, you must 
have previously saved a picture with the name "Test" in the "GraCS" folder of the open project. 


Sub OpenDocument () 

'VBA175 

Application.Documents.Open "Test.PDL", hmiOpenDocumentTypeVisibl 
End Sub 
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See also 
Hide Property (Page 2270) 
Documents Object (Listing) (Page 1952) 
VBA Reference (Page 1745) 


PasteClipboard Method 


Description 
Pastes the contents of the clipboard into the specified picture. 
Note 
The clipboard must contain objects from the Graphics Designer. Other contents (such as ASCII 
text) will not be pasted. 
syntax 
Expression.PasteClipboard () 
Expression 
Necessary. An expression or element which returns an object of the "Document" type. 
Parameters 
Example: 


In the following example all the objects selected in the active picture are copied to the clipboard 
and then pasted into a new picture. For this example to work, you must have selected at least 
one object in the active picture: 


Sub CopySelectionToNewDocument () 

"VBA176 

Dim iNewDoc As String 

ActiveDocument.CopySelection 
Application.Documents.Add hmiOpenDocumentTypeVisibl 
iNewDoc = Application.Documents.Count 
Application.Documents (iNewDoc) .PasteClipboard 

End Sub 
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See also 

ActiveDocument Property (Page 2107) 

Document Object (Page 1949) 

CopySelection Method (Page 1823) 

Add Method (Documents Listing) (Page 1790) 

Activate Method (Page 1785) 

VBA Reference (Page 1745) 
PrintDocument Method 
Description 

Prints the specified copy of the picture using the current printer settings. 
syntax 

Expression.PrintDocument () 

Expression 

Necessary. An expression or element which returns an object of the "View" type. 
Parameters 
Example: 


In the following example a copy of the active picture is created and then activated and printed: 


Sub CreateAndPrintView () 

'VBA177 

Dim objView As HMIView 

Set objView = ActiveDocument.Views.Add 
objView.Activate 

obj View. PrintDocument 

End Sub 


See also 
View Object (Page 2102) 
VBA Reference (Page 1745) 
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PrintProjectDocumentation Method 


Description 


syntax 


Parameters 


Example: 


Prints out the project documentation for the current picture complete with all the objects it 
contains and their properties via the reporting system in WinCC (Report Designer). 


You must first have set the print settings (such as page range) in the "Print Job Properties" 
dialog. To do this, go to the Graphics Designer and select the menu command "File" > "Project 
Documentation - Setup". 


Note 


The project documentation will be output on the printer that was set up in the Report Designer. 
You can design the print layout to suit your needs with the aid of the Report Designer. 


Expression.PrintProjectDocumentation () 


Expression 
Necessary. An expression or element which returns an object of the "Document" type. 


In the following example the project documentation for the active picture will be printed: 


Sub ToPrintProjectDocumentation() 


'VBA178 


ActiveDocument.PrintProjectDocumentation 


End Sub 


See also 
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Remove Method 


Description 
Removes an object from a selection of objects or from a group object. 
syntax 
Expression.Remove (Index) 
Expression 
Necessary. An expression or element which returns an object of the "GroupedObjects" or 
"Selection" type. 
Parameters 
Parameter (Data Type) Description 
Index (Variant) The name or index number of the object that is 


intended to be removed. 


You can use the Object Name as the name. As the 
index number you can use a numerical expression 
(from 1 up to the value of the Count property of the 
listing). 

If the entered value fails to match any element in 
the listing, this counts as an error. 
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Example: 


In the following example three objects will first be inserted in the active picture and selected. 
Then one object will be removed from the selection and the remaining objects will be grouped. 
Then the first object will be removed from the group object: 


Sub RemoveObjectFromGroup () 
"VBA179 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 
Dim objEllipse As HMIEllipse 

Dim objGroup As HMIGroup 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "“HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SRectangle", "HMIRectangle") 


Set objEllipse = ActiveDocument.HMIObjects.AddHMIObject ("s 


With objCircle 
-Top = 30 

-Left = 0 
-Selected = Tru 
End With 

With objRectangle 
-Top = 80 

-Left = 42 

-Selected = Tru 

End With 

With objEllipse 

-Top = 48 

.Left = 162 

-Width = 40 

-BackColor = RGB(255, 0, O) 

-Selected = Tru 

End With 

sgBox "Objects selected!" 

Set objGroup = ActiveDocument.Selection.CreateGroup 
sgBox "Group-object is created." 
objGroup.GroupedHMIObjects.Remove ("sEllipse") 
sgBox "Th llipse is removed from group-object." 
End Sub 


See also 
SelectedObjects object (Listing) (Page 2060) 


GroupedObjects Object (Listing) (Page 1983) 


VBA Reference (Page 1745) 


Rotate Method 


Description 


Fllipse", "HMIEllipse") 


Rotates the object selected in the specified picture by 90° clockwise. 
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Necessary. An expression or element which returns an object of the "Selection" type. 


syntax 
Expression.Rotate () 
Expression 
Parameters 
Example: 


3.6 VBA Reference 


In the following example two objects will be inserted in the active picture and then grouped. 


The group object will then be rotated once: 


Sub RotateGroupObject () 

"VBA180 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 
Dim objGroup As HMIGroup 


Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("sRectangle", 
Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", 


With objRectangle 

-Top = 30 

-Left = 30 

-Width = 80 

-Height = 40 

-Selected = Tru 

End With 

With objCircle 

-Top = 30 

-Left = 30 

»-BackColor = RGB(255, 255, 255) 
-Selected = Tru 

End With 

SsgBox "Objects selected!" 

Set objGroup = ActiveDocument.Selection.CreateGroup 
sgBox "Group-object created." 
objGroup.Selected = Tru 
ActiveDocument.Selection.Rotate 
End Sub 


See also 
VBA Reference (Page 1745) 
SelectedObjects object (Listing) (Page 2060) 
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SameHeight Method 


Description 


Sets the "Height" property for all selected objects in the specified picture to the smallest 
available value. 


syntax 

Expression.SameHeight () 

Expression 

Necessary. An expression or element which returns an object of the "Selection" type. 
Parameters 
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Example: 


In the following example three objects of different sizes will be inserted in the active picture. 
Then all objects will be selected and set to the same height: 


Sub ApplySameHeightToSelectedObjects () 
'VBA181 
Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 

Dim objEllipse As HMIEllipse 

Dim objGroup As HMIGroup 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "“HMICircle") 

Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SRectangle", "HMIRectangle") 
Set objEllipse = ActiveDocument.HMIObjects.AddHMIObject ("SEllipse", "HMIEllipse") 

With objCircle 

-Top = 30 

-Left = 0 

-Height = 15 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 42 

-Height = 40 

-Selected = Tru 

End With 

With objEllipse 

-Top = 48 

.Left = 162 

-Width = 40 

-Height = 120 

-BackColor = RGB(255, 0, O) 
-Selected = Tru 

End With 

SsgBox "Objects selected!" 
ActiveDocument.Selection.SameHeight 
End Sub 


See also 
Height Property (Page 2269) 
SelectedObjects object (Listing) (Page 2060) 
VBA Reference (Page 1745) 
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SameWidth Method 


Description 
Sets the "Width" property for all selected objects in the specified picture to the smallest 
available value. 
syntax 
Expression.SameWidth () 
Expression 
Necessary. An expression or element which returns an object of the "Selection" type. 
Parameters 
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Example: 


In the following example three objects of different sizes will be inserted in the active picture. 
Then all objects will be selected and set to the same width: 


Sub ApplySameWidthToSelectedObjects () 
"VBA182 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 

Dim objEllipse As HMIEllipse 

Dim objGroup As HMIGroup 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "“HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SRectangle", "HMIRectangle") 
Set objEllipse = ActiveDocument.HMIObjects.AddHMIObject ("SEllipse", "HMIEllipse") 
With objCircle 

-Top = 30 

-Left = 0 

-Width = 15 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 42 

-Width = 40 

-Selected = Tru 

End With 

With objEllipse 

-Top = 48 

.Left = 162 

-Width = 120 

-BackColor = RGB(255, 0, O) 

-Selected = Tru 

End With 

sgBox "Objects selected!" 
ActiveDocument.Selection.SameWidth 
End Sub 


See also 
Width Property (Page 2553) 
SelectedObjects object (Listing) (Page 2060) 
VBA Reference (Page 1745) 


SameWidthAndHeight Method 


Description 


Sets the "Height" and "Width" properties for all selected objects in the specified picture to the 
smallest available value. 
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Necessary. An expression or element which returns an object of the "Selection" type. 


syntax 
Expression.SameWidthAndHeight () 
Expression 

Parameters 

Example: 


In the following example three objects of different sizes will be inserted in the active picture. 
Then all objects will be selected and set to the same height: 


Sub ApplySameWidthAndHeightToSelectedObjects () 


'VBA183 
Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 
Dim objEllipse As HMIEllipse 

Dim objGroup As HMIGroup 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "“HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SRectangle", "HMIRectangle") 


Set objEllipse = ActiveDocument.HMIObjects.AddHMIObject ("s! 


With objCircle 
-Top = 30 

-Left = 0 
-Height = 15 
-Selected = Tru 
End With 

With objRectangle 
-Top = 80 

-Left = 42 

-Width = 25 

-Height = 40 

-Selected = Tru 

End With 

With objEllipse 

-Top = 48 

-Left = 162 

-Width = 40 

-Height = 120 

-BackColor = RGB(255, 0, O) 

-Selected = Tru 

End With 

sgBox "Objects selected!" 
ActiveDocument.Selection.SameWidthAndHeight 
End Sub 
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See also 

Width Property (Page 2553) 

Height Property (Page 2269) 

SelectedObjects object (Listing) (Page 2060) 

VBA Reference (Page 1745) 
Save Method 
Description 

Saves the specified picture under its current name. 
syntax 

Expression.Save () 

Expression 

Necessary. An expression or element which returns an object of the "Document" type. 
Parameters 
Example: 


In the following example the active picture in the Graphics Designer will be saved: 


Sub SaveDocument () 
'VBA184 
ActiveDocument.Sav 
End Sub 


See also 
ActiveDocument Property (Page 2107) 
Document Object (Page 1949) 
VBA Reference (Page 1745) 
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SaveAll Method 


Description 

Saves all the open pictures in the Graphics Designer under their current names. 
syntax 

Expression.SaveA11 () 

Expression 

Necessary. An expression or element which returns an object of the "Documents" type. 
Parameters 
Example: 


In the following example all open pictures in the Graphics Designer are saved: 


Sub SaveAllDocuments () 
"VBA185 
Application.Documents.SaveAll 
End Sub 


See also 
Documents Object (Listing) (Page 1952) 
VBA Reference (Page 1745) 


SaveAs Method 


Description 
Saves the specified picture under a new name. 
If a previously existing picture is to be overwritten, it must be ascertained prior to the SaveAs 
method call that this picture is permitted to be overwritten. You must inquire the 
LockedByCreatorID property of the picture to be overwritten to do so. Otherwise an error will 
be triggered in VBA. 

syntax 


Expression.SaveAs (FileName) 
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Necessary. An expression or element which returns an object of the "Document" type. 


Parameters 
Parameter (Data Type) Description 
FileName (String) The file name under which the picture is to be 
saved. 
Example: 


In the following example the active picture will be saved under the name "Test2.PDL": 


Sub SaveDocumentAs () 
'VBA186 


ActiveDocument.SaveAs ("Test2.PDL") 


End Sub 


See also 


LockedByCreatorID Property (Page 2314) 
ActiveDocument Property (Page 2107) 
Document Object (Page 1949) 

VBA Reference (Page 1745) 


SaveDefaultConfig Method 


Description 


Saves the default settings for objects to a PDD file. The file is saved to the "GraCS" folder of 


the current project. 


syntax 


Expression.SaveDefaultConfig (FileName) 


Expression 


Necessary. An expression or element which returns an object of the "Application" type. 
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Parameters 
Parameter (Data Type) 
FileName (String) The name of the PDD file. 

Example: 


In the following example the default settings for objects are saved to the file "Test. PDD". 


Sub SaveDefaultConfig() 

'VBA187 

Application.SaveDefaultConfig ("Test.PDD") 
End Sub 


See also 
Application Object (Page 1909) 
LoadDefaultConfig Method (Page 1863) 
VBA Reference (Page 1745) 


SelectAll Method 


Description 

Selects all the objects in the specified picture and adds them to the selection listing. 
syntax 

Expression.SelectAl1 () 

Expression 

Necessary. An expression or element which returns an object of the "Selection" type. 
Parameters 
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Example: 
In the following example three objects will be inserted in the active picture and then selected. 


Sub SelectAllObjectsInActiveDocument () 

'VBA188 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 

Dim objEllipse As HMIEllipse 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "“HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SRectangle", "HMIRectangle") 
Set objEllipse = ActiveDocument.HMIObjects.AddHMIObject ("SEllipse", "HMIEllipse") 
With objCircle 

-Top = 30 

-Left = 0 

-Height = 15 

End With 

With objRectangle 

-Top = 80 

-Left = 42 

-Width = 25 

-Height = 40 

End With 

With objEllipse 

-Top = 48 

.Left = 162 

-Width = 40 

-Height = 120 

-BackColor = RGB(255, 0, O) 


End With 

ActiveDocument.Selection.SelectAll 

End Sub 

See also 
SelectedObjects object (Listing) (Page 2060) 
VBA Reference (Page 1745) 

SendToBack Method 

Description 


Sends the selected objects right to the back within their current layer. 


Note 


If the "SendToBack" method is used, the sequence of HMI objects can change in the 
HMlObjects listing. 
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Syntax 

Expression.SendToBack () 

Expression 

Necessary. An expression or element which returns an object of the "Selection" type. 
Parameters 
Example: 


In the following example two objects are inserted in the active picture. The object inserted first 
is then sent to the back: 


Sub SendObjectToBack () 

"VBA197 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "“HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SsRectangle", "HMIRectangle") 
With objCircle 

-Top = 40 

-Left = 40 

-Selected = Fals 

End With 

With objRectangle 

-Top = 40 

-Left = 40 

-Width = 100 

-Height = 50 

-BackColor = RGB(255, 0, 255) 

-Selected = Tru 

End With 

sgBox "The objects circle and rectangle are created" & vbCrLf & "Only the rectangle is 
selected!" 

ActiveDocument.Selection.SendToBack 

sgBox "The selection is moved to the back." 

End Sub 


See also 
SelectedObjects object (Listing) (Page 2060) 
VBA Reference (Page 1745) 
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SetCSLayerVisible Method 


Description 
Shows or hides the specified CS layer. 
syntax 
Expression.SetCSLayerVisible (Index, Val) 
Expression 
Necessary. An expression or element which returns an object of the "View" type. 
Parameters 
Parameter (Data Type) Description 
Index (Variant) Defines the CS layer that is going to be shown or 
hidden. Value range from 1 up to 32. 
Val (Boolean) TRUE if the specified CS layer is intended to be 
visible. 
Example: 


In the following example the second CS layer in the copy of the active picture is hidden (i.e. 
made invisible): 


Sub SetCSLayerVisible() 

'VBA189 

Dim objView As HMIView 

Set objView = ActiveDocument.Views.Add 
objView.Activate 
objView.SetCSLayerVisible 2, False 

End Sub 


See also 
Document Object (Page 1949) 
VBA Reference (Page 1745) 
Editing Layers with VBA (Page 1657) 
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SetOpenContext method 


Description 


The SetOpenContext method sets the password. Password-protected process pictures can 


then be opened. 


Syntax 
Expression.SetOpenContext (Password) 
Expression 
Required. An expression or element which returns an object of the "Documents" type. 
Parameter 
Parameter (Data Type) Description 
Password (String) Password of the available picture. 
Example 


Several pictures ("A.pdl", "B.pdl" und "C.pdl") are opened in the following example using the 
same password string "Test123". Enter the password for the pictures to open these. Terminate 
the SetOpenContext method with an empty string "" to prevent further access to the password. 


Sub OpenProtectedPicture () 
"VBA853 


Documents.Open ("A.pdl") 
Documents.Open ("B.pdl") 
Documents.Open ("C.pdl") 
Documents.SetOpenContext ("") 
End Sub 


SetDeclutterObjectSize Method 


Description 


Documents.SetOpenContext ("Test123") 


Specifies the size area for fading in and out of objects in the specified picture. If height and 
width of the object are outside the specified size area, the objects are faded out. 


The "ObjectSizeDecluttering" property must be set to TRUE. 


1886 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


VBA for Automated Configuration 
3.6 VBA Reference 


syntax 

Expression.SetDeclutterObjectSize (Min, Max) 

Expression 

Necessary. An expression or element which returns an object of the "Document" type. 
Parameters 

Parameter (Data Type) Description 

Min (Long) Lower size range in pixels. 

Max (Long) Upper size range in pixels. 
Example: 


In the following example the settings for the lowest layer are configured in the active picture: 


Sub ConfigureSettingsOfLayer () 
"VBA190 

Dim objLayer As HMILayer 

Set objLayer = ActiveDocument.Layers (1) 
With objLayer 

"Configure "Layer 0" 

-MinZoom = 10 

-MaxZoom = 100 

-Name = "Configured with VBA" 
End With 

"Define decluttering of objects: 
With ActiveDocument 
.LayerDecluttering = Tru 
-ObjectSizeDecluttering = Tru 
.SetDeclutterObjectSize 50, 100 


End With 
End Sub 
See also 
ObjectSizeDecluttering Property (Page 2350) 
Document Object (Page 1949) 
VBA Reference (Page 1745) 
SetRTLayerVisible Method 
Description 


Shows or hides the specified RT layer. 
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syntax 
Expression.SetRTLayerVisible (Index, Val) 
Expression 
Necessary. An expression or element which returns an object of the "Document" type. 
Parameters 
Parameter (Data Type) Description 
Index (Variant) Defines the RT layer that is going to be shown or 
hidden. Value range from 1 to 32. 
Val (Boolean) TRUE if the specified RT layer is intended to be 
visible. 
Example: 


In the following example the first RT layer in the active picture will be made visible: 


Sub SetRTLayerVisibleWithVBA () 

"VBA191 

ActiveDocument.SetRTLayerVisible 1, False 
End Sub 


See also 
Document Object (Page 1949) 


VBA Reference (Page 1745) 
Editing Layers with VBA (Page 1657) 


ShowPropertiesDialog Method 


Description 


Opens the "Object Properties" dialog. 


syntax 


Expression.ShowPropertiesDialog() 


Expression 


Necessary. An expression or element which returns an object of the "Application" type. 
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Parameters 


Example: 


In the following example the "Object Properties" dialog is opened: 


Sub ShowPropertiesDialog () 
"VBA192 

Application. ShowPropertiesDialog 
End Sub 


See also 
Application Object (Page 1909) 
VBA Reference (Page 1745) 


ShowSymbolLibraryDialog Method 


Description 
Opens the Components Library. 
syntax 
Expression.ShowS ymbolLibraryDialog() 
Expression 
Necessary. An expression or element which returns an object of the "Application" type. 
Parameters 
Example: 


In the following example the Components Library is opened: 


Sub ShowSymbolLibraryDialog() 
'VBA193 
Application.ShowSymbolLibraryDialog 
End Sub 
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See also 
Application Object (Page 1909) 
VBA Reference (Page 1745) 


ShowTagDialog Method 


Description 
Opens the "Tags" dialog. 
syntax 
Expression.ShowTagDialog () 
Expression 
Necessary. An expression or element which returns an object of the "Application" type. 
Parameters 
Example: 


In the following example the "Tags" dialog is opened: 


Sub ShowTagDialog() 
'VBA194 

Application. ShowTagDialog 
End Sub 


See also 
Application Object (Page 1909) 
VBA Reference (Page 1745) 


TileWindowsHorizontally Method 


Description 


Arranges all open pictures in the Graphics Designer so that they are tiled horizontally. 
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syntax 

Expression.Methode () 

Expression 

Necessary. An expression or element which returns an object of the "Application" type. 
Parameters 
Example: 


In the following example all open pictures in the Graphics Designer are tiled horizontally. For 
this example to work, you must have opened a number of pictures in the Graphics Designer: 


Sub TileWindowsHorizontally() 
'VBA195 

Application. TileWindowsHorizontally 
End Sub 


See also 
Application Object (Page 1909) 
VBA Reference (Page 1745) 


TileWindowsVertically Method 


Description 

Arranges all open pictures in the Graphics Designer so that they are tiled vertically. 
syntax 

Expression.Methode () 

Expression 

Necessary. An expression or element which returns an object of the "Application" type. 
Parameters 
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Example: 


In the following example all open pictures in the Graphics Designer are tiled vertically. For this 
example to work, you must have opened a number of pictures in the Graphics Designer: 


Sub TileWindowsVertically() 
'VBA196 

Application. TileWindowsVertically 
End Sub 


See also 
Application Object (Page 1909) 
VBA Reference (Page 1745) 


TransformDisplayCoordinate method 


Description 
Is used internally for PowerCC. 


TransformPixelCoordinate method 


Description 
Is used internally for PowerCC. 
Ungroup Method 
Description 
Ungroups a group object. The objects remain intact. 
syntax 
Expression.Ungroup (Parameter) 
Expression 
Necessary. An expression or element which returns an object of the "Group" type. 
Parameters 
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Example: 


In the following example three objects are created in the current picture and a group object is 
then created from them: The group object is then moved and ungrouped. 


Sub DissolveGroup () 

"VBA199 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 

Dim objEllipse As HMIEllipse 

Dim objGroup As HMIGroup 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "HMICircle") 

Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SRectangle", "HMIRectangle") 
Set objEllipse = ActiveDocument.HMIObjects.AddHMIObject ("SEllipse", "HMIEllipse") 

With objCircle 

-Top = 30 

-Left = 0 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 42 
-Selected = Tru 
End With 

With objEllipse 
-Top = 48 

.Left = 162 

-Width = 40 

-BackColor = RGB(255, 0, O) 

-Selected = Tru 

End With 

sgBox "Objects selected!" 

Set objGroup = ActiveDocument.Selection.CreateGroup 


sgBox "Group-object is created." 
With objGroup 

.Left = 120 

-Top = 300 

sgBox "Group-object is moved." 
.UnGroup 

sgBox "Group is dissolved." 

End With 

End Sub 


See also 
Group Object (Page 1978) 
CreateGroup Method (Page 1829) 
VBA Reference (Page 1745) 
Group Objects (Page 1674) 
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3.6.1.7 Objects and Lists 
0-9, A-C 

3DBarGraph Object 

Description 


Represents the "3D Bar" object. The 3DBarGraph object is an element of the following listings: 
e@ HMlObjects: Contains all objects of a picture. 


@ Selection: Contains all selected objects of a picture. 


VBA Object Name 
HMI3DBarGraph 


Application 


Use the Add method to create a new "3D Bar" object in a picture: 


Sub Add3DBarGraph () 


'VBA200 

Dim obj3DBarGraph As HMI3DBarGraph 

Set obj3DBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("3DBar", "“HMI3DBarGraph") 
End Sub 


Use "HMIObjects"(Index)" to return an object from the HMlObjects listing, where "Index" in this 
case identifies the object by name: 


Sub Edit3DBarGraph () 

"VBA201 

Dim obj3DBarGraph As HMI3DBarGraph 

Set obj3DBarGraph = ActiveDocument.HMIObjects ("3DBar") 
obj 3DBarGraph.BorderColor = RGB(255, 0, 0) 

End Sub 
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Use "Selection(Index)" to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

"VBA202 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name from the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 


End Sub 
Object properties 
The 3D Bar object possesses the following properties: 
e AngleAlpha 
e AngleBeta 
e Application 
e Axe 


e BackColor 

e Background 

e BarDepth 

e BarHeight 

e BarWidth 

e BaseX 

e BaseY 

e BorderColor 

e BorderStyle 

e BorderWidth 

e Direction 

e FillColor 

e FillStyle 

@ GlobalColorScheme 

@ GlobalShadow 

e GroupParent 

e Height 

e Layer 

e Layer00Checked ... Layer10Checked 
e Layer00Color ... Layer10Color 
e Layer00FillColor ... Layer10FillColor 
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e Layer00FillStyle ... Layer10FillStyle 
e Layer00Value ... Layer10Value 
e Left 

e LightEffect 

@ Max. 

e Min. 

@ ObjectName 

© Operation 

e Parent 

e PasswordLevel 

e PredefinedAngles 
e Process 

e Selected 

@ ShowBadTagState 
@ TabOrderAlpha 

e TabOrderSwitch 
@ ToolTipText 

e Top 

e Transparency 

e Type 

e Visible 

e Width 


e ZeroPointValue 


See also 
SelectedObjects object (Listing) (Page 2060) 
HM|Objects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
AddHMlObject Method (Page 1801) 
VBA Reference (Page 1745) 
Editing Objects with VBA (Page 1660) 
ZeroPointValue Property (Page 2559) 
Width Property (Page 2553) 
Visible Property (Page 2551) 
Top Property (Page 2446) 
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ToolTipText Property (Page 2445) 
Process Property (Page 2383) 
PredefinedAngels Property (Page 2381) 
PasswordLevel Property (Page 2362) 
Operation Property (Page 2353) 

Name Property (Page 2343) 

Min Property (Page 2340) 

Max Property (Page 2322) 

LightEffect Property (Page 2306) 

Left Property (Page 2305) 

Layer Property (Page 2293) 
Layer00..10Value property (Page 2296) 
Height Property (Page 2269) 

Direction Property (Page 2213) 
BorderWidth Property (Page 2161) 
BorderStyle Property (Page 2160) 
BorderColor Property (Page 2153) 
BaseY Property (Page 2147) 

BaseX Property (Page 2146) 

BarWidth Property (Page 2143) 
BarHeight Property (Page 2142) 
BarDepth Property (Page 2141) 
Background Property (Page 2140) 

Axe Property (Page 2129) 

AngleBeta Property (Page 2120) 
AngleAlpha Property (Page 2119) 
Layer00..10Checked property (Page 2293) 
Layer00..10Color property (Page 2294) 
Application Property (Page 2121) 
BackColor Property (Page 2131) 
FillColor Property (Page 2231) 

FillStyle Property (Page 2235) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
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ObjectName Property (Page 2347) 
Parent Property (Page 2359) 

Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 

Type Property (Page 2450) 
Layer00..10FillColor property (Page 2295) 
Layer00..10FillStyle property (Page 2295) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


Actions Object (Listing) 


Description 


Displays a listing of the actions that are configured on an event. 


VBA Object Name 


1898 


HM|Actions 
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Usage 


Use the AddAction method to configure one or more actions on an event. In this example a 
button and a circle will be inserted in the active picture. In runtime the radius of the circle 
enlarges every time you click the button: 


Sub CreateVBActionToClickedEvent () 
"VBA203 
Dim objButton As HMIButton 
Dim objCircle As HMICircle 
Dim objVBScript As HMIScriptInfo 
Dim strVBCode As String 
Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle VB", "HMICircle") 
Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMTButton") 
With objCircle 
-Top = 100 
-Left = 100 
-BackColor = RGB(255, 0, O) 
End With 
With objButton 
-Top = 10 
-Left = 10 
Text = "Increase Radius" 
End With 
‘define event and assign sourcecode to it: 
Set objVBScript = objButton.Events(1).Actions.AddAction (hmiActionCreationTypeVBScript) 
strVBCode = "Dim myCircle" & vbCrLf & "Set myCircle = " 
strVBCode = strVBCode & "HMIRuntime.ActiveScreen.ScreenItems (""Circle VB"")" 
strVBCode = strVBCode & vbCrLf & "myCircle.Radius = myCircle.Radius + 5" 
With objVBScript 
-SourceCode = strVBCode 
End With 
End Sub 


See also 
AddAction Method (Page 1794) 
Configuring Event-Driven Actions with VBA (Page 1699) 
Parent Property (Page 2359) 
Item Property (Page 2283) 
Count Property (Page 2201) 
Application Property (Page 2121) 
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ActiveXControl Object 


Represents the ActiveX Control object. The ActiveXControl object is an element of the following 


e HMlObjects: Contains all objects of a picture. 


@ Selection: Contains all selected objects of a picture. 


Description 
listings: 
VBA Object Name 
HMlActivexXControl 
Usage 


Use the AddActiveXControl method to insert an ActiveX Control in a picture, for instance. In 
the following example the ActiveX Control "WinCC Gauge Control" is inserted in the active 


picture. 


Sub AddActiveXControl () 
"VBA204 


Dim objActiveXControl As HMIActiveXControl 


Set objActiveXControl = ActiveDocument .HMIObjects.AddActivexXControl ("WinCC_ Gauge", 


"XGAUGE.XGaugeCtr1l.1") 

With ActiveDocument 
-HMIObjects ("WinCC_Gauge") . 
-HMIObjects ("WinCC_Gauge") 
End With 

End Sub 


See also 


Top = 40 


-Left = 40 


ServerName Property (Page 2415) 
AddActiveXControl Method (Page 1795) 
VBA Reference (Page 1745) 

ActiveX controls (Page 1671) 
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ProgID Property (Page 2386) 
Application Property (Page 2121) 
Events Property (Page 2223) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
Height Property (Page 2269) 

Layer Property (Page 2293) 
LDTooltipTexts Property (Page 2303) 
Left Property (Page 2305) 

ObjectName Property (Page 2347) 
Operation Property (Page 2353) 

Parent Property (Page 2359) 
PasswordLevel Property (Page 2362) 
Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
ToolTipText Property (Page 2445) 

Top Property (Page 2446) 
Transparency property (Page 2447) 
Type Property (Page 2450) 

Visible Property (Page 2551) 

Width Property (Page 2553) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


AdvancedAnalogDisplay object 


Description 


Represents the "Analog Display (Advanced)" object. The "AdvancedAnalogDisplay" object is 
an element of the following listings: 


@ Objects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 


e HM|DefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 
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VBA Object Name 


Application 


HMIAdvancedAnalogDisplay 


Use the AddHMIObject method to create a new "Analog Display (Advanced)" object in a 


picture: 


Sub AddAdvancedAnalogDisplay () 


"VBA857 


End Sub 


Dim objAdvancedAnalogDisplay As HMIAdvancedAnalogDisplay 
Set objAdvancedAnalogDisplay = ActiveDocument.HMIObjects.AddHMIObject ("Analogdisplayl", 
"HMTAdvancedAnalogDisplay") 


Use "HMIObjects"(Index)" to return an object from the HMIObjects listing, where "Index" in this 


case identifies the object by name: 


Sub EditAdvancedAnalogDisplay () 


"VBA858 


End Sub 


See also 


1902 


Dim objAdvancedAnalogDisplay As HMIAdvancedAnalogDisplay 
Set objAdvancedAnalogDisplay = ActiveDocument.HMIObjects ("Analogdisplayl") 
objAdvancedAnalogDisplay.BackColor Simulation = RGB(255, 0, 0) 


AlarmGoneVisible property (Page 2114) 
AlignmentLeft Property (Page 2117) 
AlignmentTop Property (Page 2118) 
Application Property (Page 2121) 

BackColor Property (Page 2131) 
BackColor_Alarm.._Warning property (Page 2134) 
BackFillColor property (Page 2136) 
BackFillColor_OK property (Page 2136) 
BackFillColor_Simulation property (Page 2137) 
BackFillStyle property (Page 2137) 
BackFillStyle_OK property (Page 2137) 
BackFillStyle_Simulation property (Page 2137) 
BorderColor Property (Page 2153) 
BorderWidth Property (Page 2161) 
UseGlobalAlarmClasses property (Page 2465) 
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CBackColorOff..ColorOn property (Page 2169) 
CBackFlash property (Page 2170) 

CollectValue property (Page 2182) 
CornerRadius property (Page 2201) 
CQBackColorOff..ColorOn property (Page 2203) 
CQBackFlash property (Page 2203) 
CQTextColorOff..ColorOn property (Page 2203) 
CTextColorOff..ColorOn property (Page 2204) 
CQTextFlash property (Page 2204) 

CTextFlash property (Page 2204) 
EventQuitMask property (Page 2222) 
EnableFlashing property (Page 2221) 

Events Property (Page 2223) 

FontBold Property (Page 2256) 

Fontltalic Property (Page 2257) 

FontName Property (Page 2257) 

FontSize Property (Page 2258) 

FontUnderline Property (Page 2259) 

ForeColor Property (Page 2260) 

Format property (Page 2263) 
ForeColor_Alarm.._Warning property (Page 2261) 
GlobalShadow property (Page 2264) 
GNQBackColorOff..ColorOn property (Page 2264) 
GNQBackFlash property (Page 2265) 
GNQTextColorOff..ColorOn property (Page 2265) 
GNQTextFlash property (Page 2265) 
GroupParent Property (Page 2268) 

Height Property (Page 2269) 

Layer Property (Page 2293) 

LDTooltipTexts Property (Page 2303) 

Left Property (Page 2305) 

MessageClass Property (Page 2339) 
ObjectName Property (Page 2347) 

Operation Property (Page 2353) 

Orientation Property (Page 2356) 
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OutputValue property (Page 2359) 
PaintColor_QualityCodeBad property (Page 2359) 
PaintColor_QualityCodeUnCertain property (Page 2359) 
Parent Property (Page 2359) 
PasswordLevel Property (Page 2362) 
PrioAlarm..Warning property (Page 2383) 
PrioBit16..31 property (Page 2383) 
Properties Property (Page 2388) 
Relevant Property (Page 2398) 

Selected Property (Page 2412) 
ServerName Property (Page 2415) 
ShowBadTagState property (Page 2418) 
Simulation property (Page 2419) 
SimulationBit property (Page 2419) 

Tag property (Page 2435) 

tagname property (Page 2436) 

tagtype property (Page 2438) 

trend property (Page 2448) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
ToolTipText Property (Page 2445) 

Top Property (Page 2446) 

Transparency property (Page 2447) 

Type Property (Page 2450) 
UseValueText property (Page 2469) 
Visible Property (Page 2551) 

Width Property (Page 2553) 
ConnectionPoints property (Page 2198) 
FlashState property (Page 2252) 
ConnectorObjects property (Page 2199) 
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AdvancedStateDisplay object 


Description 


Represents the "State Display (Advanced)" object. The "AdvancedStateDisplay" object is an 
element of the following listings: 


@ Objects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 


e HM|DefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 


VBA Object Name 
HMlAdvancedStateDisplay 


Application 
Use the AddHMIObject method to create a new "State Display (Advanced)" object in a picture: 


Sub AddAdvancedStateDisplay () 

"VBA859 

Dim objAdvancedStateDisplay As HMIAdvancedStateDisplay 

Set objAdvancedStateDisplay = ActiveDocument.HMIObjects.AddHMIObject ("Statedisplayl", 
"HMTAdvancedStateDisplay") 

End Sub 


Use "HMIlObjects"(Index)" to return an object from the HMlObjects listing, where "Index" in this 
case identifies the object by name: 


Sub EditAdvancedStateDisplay () 

"VBA860 

Dim objAdvancedStateDisplay As HMIAdvancedStateDisplay 

Set objAdvancedStateDisplay = ActiveDocument.HMIObjects("Statedisplayl") 
objAdvancedStateDisplay.PaintColor QualityCodeBad = RGB(255, 0, 0) 

End Sub 


See also 
UseGlobalAlarmClasses property (Page 2465) 
EventQuitMask property (Page 2222) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Tag property (Page 2435) 
tagname property (Page 2436) 
tagtype property (Page 2438) 
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ToolTipText Property (Page 2445) 

Top Property (Page 2446) 

Transparency property (Page 2447) 
trend property (Page 2448) 

Type Property (Page 2450) 
UseEventState property (Page 2464) 
Visible Property (Page 2551) 

Width Property (Page 2553) 

Selected Property (Page 2412) 
ServerName Property (Page 2415) 
ShowBadTagState property (Page 2418) 
Properties Property (Page 2388) 
Relevant Property (Page 2398) 

Process property (Page 2384) 

Process1 property (Page 2384) 
Process2 property (Page 2385) 
Process3 property (Page 2385) 
PaintColor_QualityCodeBad property (Page 2359) 
PaintColor_QualityCodeUnCertain property (Page 2359) 
Parent Property (Page 2359) 
PasswordLevel Property (Page 2362) 
PrioAlarm..Warning property (Page 2383) 
PrioBit16..31 property (Page 2383) 
Maxindex property (Page 2322) 
ObjectName Property (Page 2347) 
Operation Property (Page 2353) 

Layer Property (Page 2293) 
LDTooltipTexts Property (Page 2303) 
Left Property (Page 2305) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
Height Property (Page 2269) 

Index Property (Page 2276) 

Events Property (Page 2223) 
CollectValue property (Page 2182) 
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AlarmGonevVisible property (Page 2114) 
Application Property (Page 2121) 
BasePicture property (Page 2145) 
BitPosition0..3 property (Page 2149) 
BitSelectO..3 property (Page 2150) 
ConnectionPoints property (Page 2198) 
FlashPictureState property (Page 2245) 
NibbleSelect property (Page 2345) 
ConnectorObjects property (Page 2199) 


AnalogResultInfo Object 


Description 


Displays an analog value range and associated property value in the Dynamic dialog. The 
AnalogResultInfo object is an element of the AnalogResultInfos listing: 


VBA Object Name 
HM|IAnalogResultInfo 


Usage 


Use the AnalogResultInfo object to return an individual value range and property value. Fora 
detailed example, please refer to "AnalogResultInfos Object (Listing)" in this documentation. 


See also 
AnalogResultInfos Object (Listing) (Page 1908) 
Delete Method (Page 1831) 
Value Property (Page 2469) 
RangeTo Property (Page 2396) 
Parent Property (Page 2359) 
Application Property (Page 2121) 
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AnalogResultInfos Object (Listing) 


Description 
Alisting of AnalogResultInfo objects that contain all the analog value ranges and the associated 
property value in the Dynamic dialog. 

VBA Object Name 
HMIAnalogResultInfos 

Usage 


Use the Add method to add a new value range in the Dynamic dialog. In the following example 
the radius of a circle will be dynamically configured using the Dynamic dialog, a tag name will 
be assigned and three analog value ranges will be created: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
"VBA206 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 

-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.Add 50, 40 
-AnalogResultInfos.Add 100, 80 
-AnalogResultInfos.ElseCase = 100 
End With 

End Sub 
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Use AnalogResultInfos to return the AnalogResultInfos listing. In this example the value ranges 
created in the above example will be output: 


Sub ShowAnalogResultInfosOfCircleRadius () 

'VBA207 

Dim colAResultInfos As HMIAnalogResultInfos 

Dim objAResultInfo As HMIAnalogResultInfo 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 

Dim iAnswer As Integer 

Dim varRange As Variant 

Dim varValue As Variant 

Set objCircle = ActiveDocument.HMIObjects ("Circle A") 
Set objDynDialog = objCircle.Radius.Dynamic 

Set colAResultInfos = objDynDialog.AnalogResultInfos 
For Each objAResultInfo In colAResultInfos 

varRange = objAResultInfo.RangeTo 


varValue = objAResultInfo.value 

iAnswer = MsgBox("Ranges of values from Circle A-Radius:" & vbCrLf & "Range of value to: " 
& varRange & vbCrLf & "Value of property: " & varValue, vbOKCancel) 

If vbCancel = iAnswer Then Exit For 

Next objAResultInfo 

End Sub 

See also 


Add Method (AnalogResultInfos Listing) (Page 1787) 
Parent Property (Page 2359) 

Item Property (Page 2283) 

ElseCase Property (Page 2220) 

Count Property (Page 2201) 

Application Property (Page 2121) 


Application Object 


Description 


Represents the Graphics Designer editor. The Application object contains properties and 
methods that return objects from the top layer. For example ActiveDocument returns a 
Document object. 
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VBA Object Name 
HM|Application 


Usage 


Use Application to return the Application object. In the following example the application 
version is output: 


Sub ShowApplicationVersion () 
'VBA208 

sgBox Application.Version 
End Sub 


See also 
ShowTagDialog Method (Page 1890) 
CurrentDesktopLanguage Property (Page 2205) 
TileWindowsVertically Method (Page 1891) 
TileWindowsHorizontally Method (Page 1890) 
ShowSymbolLibraryDialog Method (Page 1889) 
ShowPropertiesDialog Method (Page 1888) 
SaveDefaultConfig Method (Page 1881) 
LoadDefaultConfig Method (Page 1863) 
CascadeWindows Method (Page 1814) 
ArrangeMinimizedWindows Method (Page 1811) 
Activate Method (Page 1785) 
VBA Reference (Page 1745) 
WindowState Property (Page 2557) 
Visible Property (Page 2551) 
Version Property (Page 2550) 
VBE Property (Page 2550) 
VBAVersion Property (Page 2549) 
SymbolLibraries Property (Page 2428) 
ProjectType Property (Page 2387) 
ProjectName Property (Page 2386) 
ProfileName Property (Page 2385) 
Parent Property (Page 2359) 
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Name Property (Page 2343) 
IsConnectedToProject Property (Page 2280) 
Documents Property (Page 2217) 
DefaultHMIlObjects Property (Page 2210) 
CustomToolbars Property (Page 2208) 
CustomMenus Property (Page 2207) 
CurrentDataLanguage Property (Page 2204) 
ConfigurationFileName Property (Page 2198) 
AvailableDataLanguages Property (Page 2127) 
ApplicationDataPath Property (Page 2121) 
Application Property (Page 2121) 
ActiveDocument Property (Page 2107) 
CommandLine Property (Page 2196) 
DisableVBAEvents Property (Page 2214) 
Addins property (Page 2113) 
CopyPasteSettings property (Page 2201) 
DisablePerformanceWarnings property (Page 2213) 


ApplicationWindow Object 


Description 


Represents the "Application Window" object. The ApplicationWindow object is an element of 
the following listings: 


e@ HMlObjects: Contains all objects of a picture. 
® Selection: Contains all selected objects of a picture. 


e HMIDefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 
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VBA Object Name 
HM|ApplicationWindow 


Usage 


Use the Add method to create a new "Application Window" object in a picture: 


Sub AddApplicationWindow () 

"VBA209 

Dim objApplicationWindow As HMIApplicationWindow 

Set objApplicationWindow = ActiveDocument.HMIObjects.AddHMIObject ("AppWindow", 
"HMIApplicationWindow") 

End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditApplicationWindow () 

"VBA210 

Dim objApplicationWindow As HMIApplicationWindow 

Set objApplicationWindow = ActiveDocument.HMIObjects ("AppWindow") 
objApplicationWindow.Sizeable = True 

End Sub 

Use "Selection" (Index) to return an object from the Selection listing: 
Sub ShowNameOfFirstSelectedObject () 

"VBA211 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name from the first object of the selection: 

sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
Caption Property (Page 2168) 
SelectedObjects object (Listing) (Page 2060) 
HM|Objects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
AddHM Object Method (Page 1801) 
VBA Reference (Page 1745) 
Editing Objects with VBA (Page 1660) 
WindowBorder Property (Page 2555) 
Width Property (Page 2553) 
Visible Property (Page 2551) 
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Top Property (Page 2446) 

Sizeable Property (Page 2421) 

OnTop Property (Page 2352) 

Name Property (Page 2343) 
Moveable Property (Page 2342) 
MaximizeButton Property (Page 2322) 
Left Property (Page 2305) 

Layer Property (Page 2293) 

Height Property (Page 2269) 
CloseButton Property (Page 2182) 
Application Property (Page 2121) 
Events Property (Page 2223) 
GroupParent Property (Page 2268) 
LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 
Operation Property (Page 2353) 
Parent Property (Page 2359) 
PasswordLevel Property (Page 2362) 
Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
ToolTipText Property (Page 2445) 
ConnectionPoints property (Page 2198) 
Template property (Page 2438) 
ConnectorObjects property (Page 2199) 
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BarGraph Object 


Description 


Represents the "Bar" object. The BarGraph object is an element of the following listings: 
e@ HMlObjects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 


e HM DefaultObjects: Contains the default settings of property values of all Standard, 
Windows and Smart objects. 


VBA Object Name 
HMIBarGraph 


Application 


Use the Add method to create a new "Bar" object in a picture: 


Sub AddBarGraph () 

"VBA212 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
End Sub 


Use "HMIObjects"(Index)" to return an object from the HMlObjects listing, where "Index" in this 
case identifies the object by name: 


Sub EditBarGraph () 

"VBA213 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects("Barl") 
objBarGraph.BorderColor = RGB(255, 0, 0) 

End Sub 
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Use "Selection(Index)" to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 


"VBA214 


"Select all objects in the picture: 


ActiveDocument.Selection.SelectAll 
"Get the name from the first object of the selection: 


End Sub 


See also 


sgBox ActiveDocument.Selection(1) .ObjectName 


TypeWarningHigh Property (Page 2458) 
Max Property (Page 2322) 

FillColor Property (Page 2231) 
BorderStyle Property (Page 2160) 
SelectedObjects object (Listing) (Page 2060) 
HM|lObjects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
AddHMlObject Method (Page 1801) 

VBA Reference (Page 1745) 

Editing Objects with VBA (Page 1660) 
ZeroPointValue Property (Page 2559) 
ZeroPoint Property (Page 2558) 

Width Property (Page 2553) 

WarningLow Property (Page 2553) 
WarningHigh Property (Page 2552) 
Visible Property (Page 2551) 
TypeWarningLow Property (Page 2459) 
TypeToleranceLow Property (Page 2457) 
TypeToleranceHigh Property (Page 2456) 
TypeLimitLow4 Property (Page 2454) 
TypeLimitHigh4 Property (Page 2453) 
TypeAlarmLow Property (Page 2452) 
TypeAlarmHigh Property (Page 2451) 
Trend Property (Page 2448) 

TrendColor Property (Page 2449) 
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Top Property (Page 2446) 

ToolTipText Property (Page 2445) 
ToleranceLow Property (Page 2442) 
ToleranceHigh Property (Page 2442) 
ScalingType Property (Page 2406) 
Scaling Property (Page 2405) 
ScaleTicks Property (Page 2404) 
ScaleColor Property (Page 2403) 
RightComma Property (Page 2399) 
Process Property (Page 2383) 
PasswordLevel Property (Page 2362) 
Operation Property (Page 2353) 

Name Property (Page 2343) 

Min Property (Page 2340) 

Marker Property (Page 2321) 
LongStrokesTextEach Property (Page 2319) 
LongStrokesSize Property (Page 2319) 
LongStrokesOnly Property (Page 2318) 
LongStrokesBold Property (Page 2318) 
LimitLow4 Property (Page 2308) 
LimitHigh4 Property (Page 2307) 

Left Property (Page 2305) 

LeftComma Property (Page 2305) 
Layer Property (Page 2293) 
HysteresisRange Property (Page 2274) 
Hysteresis Property (Page 2273) 
Height Property (Page 2269) 

FontSize Property (Page 2258) 
FontName Property (Page 2257) 
FontBold Property (Page 2256) 
FlashRateBorderColor Property (Page 2249) 
FlashRateBackColor Property (Page 2247) 
FlashBorderColor Property (Page 2240) 
FlashBackColor Property (Page 2239) 
FillStyle Property (Page 2235) 
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Exponent Property (Page 2227) 

Direction Property (Page 2213) 
ColorWarningLow Property (Page 2193) 
ColorWarningHigh Property (Page 2192) 
ColorToleranceLow Property (Page 2190) 
ColorToleranceHigh Property (Page 2189) 
ColorLimitLow4 Property (Page 2187) 
ColorLimitHigh4 Property (Page 2186) 
ColorChangeType Property (Page 2185) 
ColorAlarmLow Property (Page 2183) 
ColorAlarmHigh Property (Page 2182) 
CheckWarningLow Property (Page 2179) 
CheckWarningHigh Property (Page 2178) 
CheckToleranceLow Property (Page 2177) 
CheckToleranceHigh Property (Page 2176) 
CheckLimitLow4 Property (Page 2174) 
CheckLimitHigh4 Property (Page 2172) 
CheckAlarmLow Property (Page 2171) 
CheckAlarmHigh Property (Page 2170) 
BorderWidth Property (Page 2161) 
BorderFlashColorOn Property (Page 2159) 
BorderFlashColorOff Property (Page 2157) 
BorderColor Property (Page 2153) 
BorderBackColor Property (Page 2152) 
BackFlashColorOn Property (Page 2139) 
BackFlashColorOff Property (Page 2138) 
BackColor Property (Page 2131) 
BackColor3 Property (Page 2133) 
BackColor2 Property (Page 2133) 
AxisSection Property (Page 2130) 
Average Property (Page 2128) 

Alignment Property (Page 2116) 
AlarmLow Property (Page 2115) 
AlarmHigh Property (Page 2114) 

FillStyle2 Property (Page 2237) 
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Application Property (Page 2121) 
Events Property (Page 2223) 
ObjectName Property (Page 2347) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


BinaryResultInfo Object 


Description 


Displays both the binary (boolean) value ranges and the associated property values in the 
Dynamic dialog. 


VBA Object Name 
HMIBinaryResultInfo 
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Usage 


Use BinaryResultInfo to return the BinaryResultInfo object. In the following example the radius 
of a circle will be dynamically configured using the Dynamic dialog, a tag name will be assigned 
and the associated property values will be assigned to both the binary value ranges: 


Sub AddDynamicDialogToCircleRadiusTypeBinary () 
"VBA215 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle C", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeBool 


.BinaryResultInfo.NegativeValue = 20 
.-BinaryResultInfo.PositiveValue = 40 
End With 

End Sub 

See also 


VBA Reference (Page 1745) 
PositiveValue Property (Page 2380) 
Parent Property (Page 2359) 
NegativeValue Property (Page 2344) 
Application Property (Page 2121) 


BitResultInfo Object 


Description 


Displays both the value ranges for bit set/not set and the associated property values in the 
Dynamic dialog. 


VBA Object Name 
HMIBitResultInfo 
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Usage 


Use BitResultInfo to return a BitResultInfo object. In the following example the radius of a circle 
will be dynamically configured using the Dynamic dialog, a tag name will be assigned, the bit 
to be set will be defined and the associated property values will be assigned to the "set"/"not 
set" states: 


Sub AddDynamicDialogToCircleRadiusTypeBit () 

"VBA216 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle B", "HMICircle") 

‘Tag "NewDynmicl" must exist 

Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 

With objDynDialog 

-ResultType = hmiResultTypeBit 
-BitResultInfo.BitNumber = 1 
.BitResultInfo.BitSetValue = 40 
.BitResultInfo.BitNotSetValue = 
End With 

End Sub 


80 


See also 
Delete Method (Page 1831) 
VBA Reference (Page 1745) 
BitSetValue Property (Page 2150) 
BitNumber Property (Page 2148) 
BitNotSetValue Property (Page 2148) 
Application Property (Page 2121) 
Parent Property (Page 2359) 
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Button Object 


Description 
Represents the "Button" object. The Button object is an element of the following listings: 
e@ HMlObjects: Contains all objects of a picture. 
e@ Selection: Contains all selected objects of a picture. 
e HMIDefaultObjects: Contains the default settings of property values of all Standard, 
Windows and Smart objects. 
VBA Object Name 
HM|Button 
Application 


Use the Add method to create a new "Button" object in a picture: 


Sub AddButton () 
'VBA217 
Dim objButton As HMIButton 


Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Button", "HMITButton") 
End Sub 


Use "HMIObjects"(Index)" to return an object from the HMlObjects listing, where "Index" in this 
case identifies the object by name: 


Sub EditButton () 

"VBA218 

Dim objButton As HMIButton 

Set objButton = ActiveDocument.HMIObjects ("Button") 
objButton.BorderColor = RGB(255, 0, 0) 

End Sub 
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Use "Selection(Index)" to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

"VBA219 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name from the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
ForeFlashColorOn Property (Page 2262) 
BorderColorBottom Property (Page 2155) 
SelectedObjects object (Listing) (Page 2060) 
HM|Objects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
AddHMlObject Method (Page 1801) 
VBA Reference (Page 1745) 
Editing Objects with VBA (Page 1660) 
Width Property (Page 2553) 
Visible Property (Page 2551) 
Top Property (Page 2446) 
ToolTipText Property (Page 2445) 
Text Property (Page 2439) 
PictureUp Property (Page 2374) 
PictureDown Property (Page 2372) 
PasswordLevel Property (Page 2362) 
Orientation Property (Page 2356) 
Operation Property (Page 2353) 
Left Property (Page 2305) 
Layer Property (Page 2293) 
Hotkey Property (Page 2272) 
Height Property (Page 2269) 
ForeFlashColorOff Property (Page 2261) 
ForeColor Property (Page 2260) 
FontUnderline Property (Page 2259) 
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FontSize Property (Page 2258) 

FontName Property (Page 2257) 

Fontltalic Property (Page 2257) 

FontBold Property (Page 2256) 
FlashRateForeColor Property (Page 2251) 
FlashRateBorderColor Property (Page 2249) 
FlashRateBackColor Property (Page 2247) 
FlashForeColor Property (Page 2242) 
FlashBorderColor Property (Page 2240) 
FlashBackColor Property (Page 2239) 
FillStyle Property (Page 2235) 

Fillinglndex Property (Page 2233) 

Filling Property (Page 2232) 

FillColor Property (Page 2231) 
DisplayOptions Property (Page 2215) 
BorderWidth Property (Page 2161) 
BorderStyle Property (Page 2160) 
BorderFlashColorOn Property (Page 2159) 
BorderFlashColorOff Property (Page 2157) 
BorderColorTop Property (Page 2155) 
BorderColor Property (Page 2153) 
BorderBackColor Property (Page 2152) 
BackFlashColorOn Property (Page 2139) 
BackFlashColorOff Property (Page 2138) 
BackColor Property (Page 2131) 
BackBorderWidth Property (Page 2131) 
AlignmentTop Property (Page 2118) 
AlignmentLeft Property (Page 2117) 
AdaptBorder Property (Page 2111) 

Events Property (Page 2223) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
LDFonts Property (Page 2298) 

LDTexts Property (Page 2303) 
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LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 

Parent Property (Page 2359) 
PicDownReferenced Property (Page 2367) 
PicDownTransparent Property (Page 2368) 
PicDownUseTransColor Property (Page 2369) 
PictAlignment property (Page 2370) 
PicUpReferenced Property (Page 2375) 
PicUpTransparent Property (Page 2376) 
PicUpUseTransColor Property (Page 2377) 
PicUseTransColor Property (Page 2377) 
Properties Property (Page 2388) 

Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 

Type Property (Page 2450) 

WinCCStyle property (Page 2554) 
WindowsStyle property (Page 2557) 
DrawlnsideFrame property (Page 2218) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


CheckBox Object 


Description 


1924 
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Represents the "Check Box" object. The CheckBox object is an element of the following listings: 
e HMlObjects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 


e HM|IDefaultObjects: Contains the default settings of property values of all Standard, 
Windows and Smart objects. 


VBA Object Name 
HMICheckBox 


Application 


Use the Add method to create a new "Check Box" object in a picture: 


Sub AddCheckBox () 

"VBA220 

Dim objCheckBox As HMICheckBox 

Set objCheckBox = ActiveDocument.HMIObjects.AddHMIObject ("CheckBox", "HMICheckBox") 
End Sub 


Use "HMIObjects"(Index)" to return an object from the HMlObjects listing, where "Index" in this 
case identifies the object by name: 


Sub EditCheckBox () 

"VBA221 

Dim objCheckBox As HMICheckBox 

Set objCheckBox = ActiveDocument.HMIObjects ("CheckBox") 
objCheckBox.BorderColor = RGB(255, 0, 0) 

End Sub 


Use "Selection(Index)" to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

'VBA222 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name from the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
SelectedObjects object (Listing) (Page 2060) 
HM|lObjects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
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AddHMlObject Method (Page 1801) 

VBA Reference (Page 1745) 

Editing Objects with VBA (Page 1660) 
Application Property (Page 2121) 
AdaptBorder Property (Page 2111) 
AlignmentLeft Property (Page 2117) 
AlignmentTop Property (Page 2118) 
BackColor Property (Page 2131) 
BackFlashColorOff Property (Page 2138) 
BackFlashColorOn Property (Page 2139) 
BorderBackColor Property (Page 2152) 
BorderColor Property (Page 2153) 
BorderFlashColorOff Property (Page 2157) 
BorderFlashColorOn Property (Page 2159) 
BorderStyle Property (Page 2160) 
BorderWidth Property (Page 2161) 
BoxAlignment Property (Page 2163) 
BoxCount Property (Page 2164) 

Events Property (Page 2223) 

FillColor Property (Page 2231) 

Filling Property (Page 2232) 

Fillinglndex Property (Page 2233) 

FillStyle Property (Page 2235) 
FlashBackColor Property (Page 2239) 
FlashBorderColor Property (Page 2240) 
FlashForeColor Property (Page 2242) 
FlashRateBackColor Property (Page 2247) 
FlashRateBorderColor Property (Page 2249) 
FlashRateForeColor Property (Page 2251) 
FontBold Property (Page 2256) 

Fontltalic Property (Page 2257) 

FontName Property (Page 2257) 

FontSize Property (Page 2258) 
FontUnderline Property (Page 2259) 
ForeColor Property (Page 2260) 
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ForeFlashColorOff Property (Page 2261) 
ForeFlashColorOn Property (Page 2262) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
Height Property (Page 2269) 

Index Property (Page 2276) 

Layer Property (Page 2293) 

LDFonts Property (Page 2298) 

LDTexts Property (Page 2303) 
LDTooltipTexts Property (Page 2303) 
Left Property (Page 2305) 

ObjectName Property (Page 2347) 
Operation Property (Page 2353) 
OperationMessage Property (Page 2354) 
Orientation Property (Page 2356) 

Parent Property (Page 2359) 
PasswordLevel Property (Page 2362) 
Process Property (Page 2383) 
Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Text Property (Page 2439) 

ToolTipText Property (Page 2445) 

Top Property (Page 2446) 

Transparency property (Page 2447) 
Type Property (Page 2450) 

Visible Property (Page 2551) 

Width Property (Page 2553) 
WindowsStyle property (Page 2557) 
DrawlnsideFrame property (Page 2218) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 
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Circle Object 
Description 
Represents the "Circle" object. The Circle object is an element of the following listings: 
@ Objects: Contains all objects of a picture. 
e@ Selection: Contains all selected objects of a picture. 
e HMIDefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 
VBA Object Name 
HMICircle 
Usage 


Use the Add method to create a new "Circle" object in a picture: 


Sub AddCircle() 


"VBA223 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle", "“HMICircle") 
End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditCircle() 


"VBA224 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument.HMIObjects ("Circle") 
objCircle.BorderColor = RGB(255, 0, O) 

End Sub 
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Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

"VBA225 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name from the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
FillColor Property (Page 2231) 
SelectedObjects object (Listing) (Page 2060) 
HM|lObjects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
AddHMObject Method (Page 1801) 
VBA Reference (Page 1745) 
Editing Objects with VBA (Page 1660) 
Width Property (Page 2553) 
Visible Property (Page 2551) 
Top Property (Page 2446) 
ToolTipText Property (Page 2445) 
Radius Property (Page 2394) 
PasswordLevel Property (Page 2362) 
Operation Property (Page 2353) 
Left Property (Page 2305) 
Layer Property (Page 2293) 
Height Property (Page 2269) 
FlashRateBorderColor Property (Page 2249) 
FlashRateBackColor Property (Page 2247) 
FlashBorderColor Property (Page 2240) 
FlashBackColor Property (Page 2239) 
FillStyle Property (Page 2235) 
Fillinglndex Property (Page 2233) 
Filling Property (Page 2232) 
BorderWidth Property (Page 2161) 
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1930 


BorderStyle Property (Page 2160) 
BorderFlashColorOn Property (Page 2159) 
BorderFlashColorOff Property (Page 2157) 
BorderColor Property (Page 2153) 
BorderBackColor Property (Page 2152) 
BackFlashColorOn Property (Page 2139) 
BackFlashColorOff Property (Page 2138) 
BackColor Property (Page 2131) 
Application Property (Page 2121) 

Events Property (Page 2223) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 

Parent Property (Page 2359) 

Properties Property (Page 2388) 

Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 

Type Property (Page 2450) 
DrawlnsideFrame property (Page 2218) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 
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CircularArc Object 


Description 


Represents the "Circular Arc" object. The CircularArc object is an element of the following 
listings: 


@ Objects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 


e HM|DefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 


VBA Object Name 
HM CircularArc 


Usage 


Use the Add method to create a new "Circular Arc" object in a picture: 


Sub AddCiruclarArc () 

"VBA226 

Dim objCiruclarArc As HMICircularArc 

Set objCiruclarArc = ActiveDocument.HMIObjects.AddHMIObject ("CircularArc", 
"HMICircularArc") 

End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditCiruclarArc() 

"VBA227 

Dim objCiruclarArc As HMICircularArc 

Set objCiruclarArc = ActiveDocument.HMIObjects ("CircularArc") 
objCiruclarArc.BorderColor = RGB(255, 0, 0) 

End Sub 
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Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 


"VBA228 


"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 


"Get the name from the first object of the selection: 


End Sub 


See also 


1932 


sgBox ActiveDocument.Selection(1) .ObjectName 


HM|Objects Object (Listing) (Page 1990) 
BorderBackColor Property (Page 2152) 
SelectedObjects object (Listing) (Page 2060) 
HMIDefaultObjects Object (Listing) (Page 1985) 
AddHMlObject Method (Page 1801) 

VBA Reference (Page 1745) 

Editing Objects with VBA (Page 1660) 

Width Property (Page 2553) 

Visible Property (Page 2551) 

Top Property (Page 2446) 

ToolTipText Property (Page 2445) 
StartAngle Property (Page 2426) 

Radius Property (Page 2394) 
PasswordLevel Property (Page 2362) 
Operation Property (Page 2353) 

Left Property (Page 2305) 

Layer Property (Page 2293) 

Height Property (Page 2269) 
FlashRateBorderColor Property (Page 2249) 
FlashBorderColor Property (Page 2240) 
EndAngle Property (Page 2222) 
BorderWidth Property (Page 2161) 
BorderStyle Property (Page 2160) 
BorderFlashColorOn Property (Page 2159) 
BorderFlashColorOff Property (Page 2157) 
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BorderColor Property (Page 2153) 
Application Property (Page 2121) 
Events Property (Page 2223) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 
Parent Property (Page 2359) 

Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 
Type Property (Page 2450) 
DrawlnsideFrame property (Page 2218) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


Collection object 


Description 


Allows access to a listing of objects of the same type, for example, "Documents" objects. 


See also 
Application Property (Page 2121) 
Count Property (Page 2201) 
Item Property (Page 2283) 
Parent Property (Page 2359) 
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ComboBox object 


Description 


HM|IDefaultObjects 
HMlIObjects 


Represents the "ComboBox" object. The ComboBox object is an element of the following lists: 


e@ HM Objects: Contains all objects of a picture. 
® Selection: Contains all selected objects of a picture. 


e HM|DefaultObjects: Contains the default property values of all default, smart, window and 
tube objects. 


VBA object name 
HMIComboBox 


Usage 


Use the Add method to create a new "ComboBox" object in a picture: 


Sub AddComboBox () 


'VBA822 

Dim objComboBox As HMIComboBox 

Set objComboBox = ActiveDocument .HMIObjects.AddHMIObject ("ComboBox", "HMIComboBox") 
End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditComboBox () 

"VBA850 

Dim objComboBox As HMIComboBox 

Set objComboBox = ActiveDocument.HMIOb jects ("ComboBox") 
objComboBox.BorderColor = RGB(255, 0, 0) 

End Sub 
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Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

"VBA824 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name from the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
ObjectName Property (Page 2347) 
Left Property (Page 2305) 
Layer Property (Page 2293) 
Top Property (Page 2446) 
Width Property (Page 2553) 
Height Property (Page 2269) 
NumberLines Property (Page 2346) 
ForeColor Property (Page 2260) 
BorderColor Property (Page 2153) 
BorderBackColor Property (Page 2152) 
BackColor Property (Page 2131) 
BorderStyle Property (Page 2160) 
BorderWidth Property (Page 2161) 
FillColor Property (Page 2231) 
FillStyle Property (Page 2235) 
FontName Property (Page 2257) 
FontSize Property (Page 2258) 
FontBold Property (Page 2256) 
Fontltalic Property (Page 2257) 
FontUnderline Property (Page 2259) 
AlignmentLeft Property (Page 2117) 
GlobalShadow property (Page 2264) 
Index Property (Page 2276) 
Text Property (Page 2439) 
Operation Property (Page 2353) 
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PasswordLevel Property (Page 2362) 
Visible Property (Page 2551) 
ToolTipText Property (Page 2445) 
SelText property (Page 2414) 
Sellndex property (Page 2414) 
Application Property (Page 2121) 
Events Property (Page 2223) 


GlobalColorScheme property (Page 2264) 


GroupParent Property (Page 2268) 
LDFonts Property (Page 2298) 

LDTexts Property (Page 2303) 
LDTooltipTexts Property (Page 2303) 
Parent Property (Page 2359) 

Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Type Property (Page 2450) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


ConnectionPoints Object (Listing) 


The listing returns the number of points to which the connector can be appended in the 


Description 

specified object. 
VBA object name 

HM IConnectionPoints 
1936 
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Object properties 


The ConnectionPoints object possesses the following properties: 


Application 
e Count 


e |tem 


Parent 


Example 1 


Sub 


In this example, a rectangle is inserted and the number of connection points is output: 


CountConnectionPoints() 


"VBA229 


Dim 
Dim 
Set 


objRectangle As HMIRectangle 
objConnPoints As HMIConnectionPoints 


objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMTRectangle") 


Set objConnPoints = ActiveDocument.HMIObjects("Rectanglel") .ConnectionPoints 
sgBox "Rectanglel has " & objConnPoints.Count & " connectionpoints." 

End Sub 

Example 2: 


Sub 


In this example, a text field is inserted and the connection points are accessed via 
"ConnectionPoints. Item". The coordinates of the connection points are shown in an output 
window. 


GetConnectionPoints() 


"VBA825 


Dim 
Dim 
Dim 


set 


xPos As Long 
yPos As Long 
objConnPoints As HMIConnectionPoints 


objDoc = Application.ActiveDocument 


Set objObject = objDoc.HMIObjects.AddHMIObject ("Text", "HMIStaticText") 
Set objConnPoints = ActiveDocument.HMIObjects ("Text") .ConnectionPoints 
For i = 1 To objConnPoints.Count 
xPos = objObject.ConnectionPoints.Item(i) (0) 
yPos = objObject.ConnectionPoints.Item(i) (1) 
MsgBox "Coordinates " & i & ". ConnectionPoint:" & Chr(13) & "x: " & xPos & Chr(13) & 
"vy: " & yPos 
Next 
End Sub 


The diagram below shows the positions of the 4 connection points of the text field. 
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Note 

If you activate the connection points of a connector with VBA, the connection point index begins 
with "1". 

If you determine the connection points in the property window of the connector in the graphical 
interface, the connection point index begins with "0". 


The index numbers e.g. of the lower connection point in the picture are assigned as follows: 
e VBA: Index = 3 
e@ Graphical interface: Index = 2 


See also 
Parent Property (Page 2359) 
Item Property (Page 2283) 
Count Property (Page 2201) 
Application Property (Page 2121) 


CustomizedObject Object 


Description 
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Represents the object called "Customized Object". The CustomizedObject object is an element 
of the following listings: 


@ Objects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 


In the case of the CustomizedObject object, the only properties that are available in the object 
are those that you have selected in the "Configuration" dialog for the customized object 
concerned. 


Note 


You cannot configure the CustomizedObject object with VBA. 


Further information regarding customized objects can be found in the WinCC documentation 
under "Customized Object". 


VBA Object Name 
HM ICustomizedObject 


Application 


Use the CreateCustomizedObject Method with the Selection listing to create a new 
"Customized Object" object in a picture: 


Sub CreateCustomizedObject () 

"VBA230 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 

Dim objCustomizedObject As HMICustomizedObject 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("Rectangle B", "HMIRectangle") 
With objCircle 

-Left = 10 

-Top = 10 

-Selected = Tru 

End With 

With objRectangle 

-Left = 50 

-Top = 50 

-Selected = Tru 

End With 


sgBox "objects created and selected!" 

Set objCustomizedObject = ActiveDocument.Selection.CreateCustomizedObject 
objCustomizedObject.ObjectName = "Customer-Object" 

End Sub 
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Use "HMIlObjects"(Index)" to return an object from the HMlObjects listing, where "Index" in this 
case identifies the object by name: 


Sub EditCustomizedObject () 

"VBA231 

Dim objCustomizedObject As HMICustomizedObject 

Set objCustomizedObject = ActiveDocument.HMIObjects ("Customer-Object") 
sgBox objCustomizedObject.ObjectNam 

End Sub 


See also 
SelectedObjects object (Listing) (Page 2060) 
HM|lObjects Object (Listing) (Page 1990) 
Destroy Method (Page 1835) 
Delete Method (Page 1831) 
CreateCustomizedObject Method (Page 1825) 
How to Edit a Customized Object with VBA (Page 1683) 
VBA Reference (Page 1745) 
Customized Objects (Page 1682) 
Editing Objects with VBA (Page 1660) 
Application Property (Page 2121) 
Events Property (Page 2223) 
GroupParent Property (Page 2268) 
Height Property (Page 2269) 
InheritState property (Page 2278) 
Layer Property (Page 2293) 
LDTooltipTexts Property (Page 2303) 
Left Property (Page 2305) 
ObjectName Property (Page 2347) 
Operation Property (Page 2353) 
Parent Property (Page 2359) 
PasswordLevel Property (Page 2362) 
Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
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ToolTipText Property (Page 2445) 

Top Property (Page 2446) 

Type Property (Page 2450) 

Visible Property (Page 2551) 

Width Property (Page 2553) 
ConnectionPoints property (Page 2198) 
HMIUdoObjects property (Page 2272) 
ConnectorObjects property (Page 2199) 


D-I 
DataLanguage Object 
Description 
Represents the installed project language, which is identified by its name and language 
identifier. The DataLanguage object is an element of the DataLanguages listing: 
The list of language codes is available in the WinCC documentation (Index > Language Code). 
The hexadecimal value specified in the list has to be converted to its equivalent decimal value. 
VBA Object Name 
HMIDataLanguage 
Usage 


Use the DataLanguages property to return an individual DataLanguage object. In the following 
example the first installed project language is output: 


Sub ShowFirstObjectOfCollection() 
'VBA232 


Dim strName As String 

strName = ActiveDocument .Application.AvailableDataLanguages (1) .LanguageName 
sgBox strName 

End Sub 
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See also 
DataLanguages Object (Listing) (Page 1942) 
VBA Reference (Page 1745) 
Language-Dependent Configuration with VBA (Page 1624) 
Parent Property (Page 2359) 
LanguageName Property (Page 2290) 
LanguagelD Property (Page 2289) 
Application Property (Page 2121) 


DataLanguages Object (Listing) 


Description 


A listing of the DataLanguage objects that represent all the installed project languages. 


VBA Object Name 
HMIDataLanguages 
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Usage 


Use the AvailableDataLanguages property to return the DataLanguages listing. In the following 
example the installed project language is output: 


Sub ShowDataLanguage () 

"VBA233 

Dim colDataLanguages As HMIDataLanguages 

Dim objDataLanguage As HMIDataLanguage 

Dim strLanguages As String 

Dim iCount As Integer 

iCount = 0 

Set colDataLanguages = Application.AvailableDataLanguages 
For Each objDataLanguage In colDataLanguages 

If "" <> strLanguages Then strLanguages = strLanguages & "/" 
strLanguages = strLanguages & objDataLanguage.LanguageName & " " 
‘Every 15 items of datalanguages output in a messagebox 

If 0 = iCount Mod 15 And 0 <> iCount Then 

sgBox strLanguages 

strLanguages = "" 

End If 

iCount = iCount + 1 

ext objDataLanguage 

sgBox strLanguages 


End Sub 

See also 
Language-Dependent Configuration with VBA (Page 1624) 
DataLanguage Object (Page 1941) 
Item Method (Page 1859) 
VBA Reference (Page 1745) 
Parent Property (Page 2359) 
Count Property (Page 2201) 
Application Property (Page 2121) 

DataSetObj object 

Description 


The "DataSetObj" object serves as a container for the internal storage of data of the user 
objects or faceplate types. The DataSetObj object is an element of the following listings: 


@ Objects: Contains all objects of a picture. 


@ Selection: Contains all selected objects of a picture. 
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VBA Object Name 


See also 


1944 


HMIDataSetObj 


Application Property (Page 2121) 
ConnectionPoints property (Page 2198) 
Events Property (Page 2223) 
GroupParent Property (Page 2268) 
Height Property (Page 2269) 

Layer Property (Page 2293) 

LDFonts Property (Page 2298) 

Left Property (Page 2305) 
ObjectName Property (Page 2347) 
Operation Property (Page 2353) 
Parent Property (Page 2359) 
PasswordLevel Property (Page 2362) 
Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
ToolTipText Property (Page 2445) 
Top Property (Page 2446) 

Type Property (Page 2450) 

Visible Property (Page 2551) 

Width Property (Page 2553) 
ConnectorObjects property (Page 2199) 
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DestLink Object 


Description 


Represents the destination for a direct connection. 


VBA Object Name 
HM|IDestLink 
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Usage 


Use the DestinationLink property to return the DestLink object. In the following example the X 
position of "Rectangle_A" is copied to the Y position of "Rectangle_B" in Runtime by clicking 
on the button: 


Sub DirectConnection () 
"VBA234 
Dim objButton As HMIButton 

Dim objRectangleA As HMIRectangle 

Dim objRectangleB As HMIRectangle 

Dim objEvent As HMIEvent 

Dim objDirConnection As HMIDirectConnection 

Set objRectangleA = ActiveDocument.HMIObjects.AddHMIObject ("Rectangle A", "HMIRectangle") 
Set objRectangleB = ActiveDocument.HMIObjects.AddHMIObject ("Rectangle B", "HMIRectangle") 
Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMTButton") 

With objRectangleA 

-Top = 100 

-Left = 100 


With objRectangleB 

-Top = 250 

-Left = 400 

-BackColor = RGB(255, 0, O) 
End With 
With objButton 
-Top = 10 
-Left = 10 
-Width = 90 
-Height = 50 


-Text = "SetPosition" 
End With 
' 


"Directconnection is initiated on mouseclick: 

Set objDirConnection = 

objButton.Events (1).Actions.AddAction (hmiActionCreationTypeDirectConnection) 
With objDirConnection 

"Sourceobject: Property "Top" of "Rectangle A" 


-SourceLink.Type = hmiSourceTypeProperty 
-SourceLink.ObjectName = "Rectangle A" 
-SourceLink.AutomationName = "Top" 

' 

'Targetobject: Property "Left" of "Rectangle B" 
.DestinationLink.Type = hmiDestTypeProperty 
.DestinationLink.ObjectName = "Rectangle B" 
.DestinationLink.AutomationName = "Left" 

End With 

End Sub 
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See also 
DirectConnection Object (Page 1947) 
VBA Reference (Page 1745) 
Type Property (Page 2450) 
ObjectName Property (Page 2347) 
AutomationName Property (Page 2124) 
Parent Property (Page 2359) 


DirectConnection Object 


Description 


Represents a direct connection. 


VBA Object Name 
HM DirectConnection 
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Usage 
Use the 


DestinationLink and SourceLink properties to configure the source and destination of 


a direct connection. In the following example the X position of "Rectangle_A" is copied to the 
Y position of "Rectangle_B" in Runtime by clicking on the button: 


Sub DirectConnection () 
"VBA235 

Dim objButton As HMIBu 
Dim objRectangleA As H 
Dim objRectangleB As H 
Dim objEvent As HMIEve 


tton 
TRectangle 
TRectangle 
nt 


Dim objDirConnection As HMIDirectConnection 


Set objRectangleA = Ac 


Set objRectangleB = Ac 


tiveDocument .HMIObjects.AddHMIObject ("Rectangle A", "HMIRectangle") 


tiveDocument .HMIObjects.AddHMIObject ("Rectangle B", "HMIRectangle") 


Set objButton = Activ 
With objRectangleA 


-Top = 100 

-Left = 100 

End With 

With objRectangleB 
-Top = 250 

-Left = 400 


-BackColor = RGB(255, 
End With 
With objButton 


-Top = 10 

-Left = 10 

-Width = 90 

-Height = 50 

-Text = "SetPosition" 


End With 
' 


"Directconnection is i 
Set objDirConnection = 
objButton.Events (1) .Ac 
With objDirConnection 

"Sourceobject: Propert 
-SourceLink.Type = hmi 


Document .HMIObjects.AddHMIObject ("myButton", "HMIButton") 


0, 0) 


nitiated on mouseclick: 
tions.AddAction (hmiActionCreationTypeDirectConnection) 


y "Top" of "Rectangle A" 
SourceTypeProperty 


-SourceLink.ObjectNam 


= "Rectangle A" 


-SourceLink.AutomationName = "Top" 


'Targetobject: Propert 


y "Left" of "Rectangle B" 


.DestinationLink.Type = hmiDestTypeProperty 
.DestinationLink.ObjectName = "Rectangle B" 
.DestinationLink.AutomationName = "Left" 
End With 
End Sub 
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See also 
DestinationLink Property (Page 2211) 
SourceLink Object (Page 2065) 
DestLink Object (Page 1945) 
VBA Reference (Page 1745) 
SourceLink Property (Page 2422) 
Application Property (Page 2121) 
Parent Property (Page 2359) 


Document Object 


Description 
Displays a picture in Graphics Designer. The document object is an element of the documents 
listing. 

VBA Object Name 
HMIDocument 

Usage 


Use Documents(Index) to return an individual document object. In the following example the 
file name of the first picture is displayed: 


Sub ShowFirstObjectOfCollection() 
'VBA236 

Dim strName As String 

strName = Application.Documents (3) .Name 
sgBox strName 

End Sub 
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You may also use the object "Me" if you wish to address the current document: 


Sub ShowDocumentName () 
'VBA812 

Dim obj As Document 
set obj = Me 

sgBox obj .Name 

End Sub 


For example, use the SaveAs method to save the picture under a different name. In the 
following example the first picture will be saved under the name "CopyOfPicture1": 


Sub SaveDocumentAs () 

"VBA237 

Application.Documents(3).SaveAs ("CopyOfPicturel") 
End Sub 


See also 
Editing Pictures with VBA (Page 1654) 
GridHeight Property (Page 2267) 
Documents Object (Listing) (Page 1952) 
SetRTLayerVisible Method (Page 1887) 
SaveAs Method (Page 1880) 
Save Method (Page 1879) 
PrintProjectDocumentation Method (Page 1870) 
PasteClipboard Method (Page 1868) 
MoveSelection Method (Page 1865) 
IsRTLayerVisible Method (Page 1858) 
Export Method (Page 1840) 
CopySelection Method (Page 1823) 
Close Method (Page 1818) 
VBA Reference (Page 1745) 
ExtendedZoomingEnable Property (Page 2228) 
Width Property (Page 2553) 
Visible Property (Page 2551) 
Views Property (Page 2550) 
UpdateCycle Property (Page 2463) 
TabOrderOtherAction Property (Page 2432) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
1950 System Manual, 02/2016, A5E37536061-AA 


VBA for Automated Configuration 
3.6 VBA Reference 


TabOrderMouse Property (Page 2432) 
TabOrderKeyboard Property (Page 2431) 
TabOrderAllHMlObjects Property (Page 2430) 
SnapToGrid Property (Page 2422) 
HMIDefaultObjects Object (Listing) (Page 1985) 
Selection Property (Page 2413) 

Properties Property (Page 2388) 

Path Property (Page 2363) 

PasswordLevel Property (Page 2362) 

Parent Property (Page 2359) 

Operation Property (Page 2353) 

Name Property (Page 2343) 
LockedByCreatorID Property (Page 2314) 
LastChange Property (Page 2292) 
HMlIObjects Property (Page 2272) 

Hide Property (Page 2270) 

Height Property (Page 2269) 

GridWidth Property (Page 2267) 

GridColor Property (Page 2266) 

Grid Property (Page 2265) 

FillStyle Property (Page 2235) 

Events Property (Page 2223) 
CustomToolbars Property (Page 2208) 
CustomMenus Property (Page 2207) 
CursorMode Property (Page 2206) 

BackColor Property (Page 2131) 

Application Property (Page 2121) 
BackPictureAlignment property (Page 2141) 
BackPictureName property (Page 2141) 
CommonVBSCode Property (Page 2194) 
CommonVBSEventArea property (Page 2195) 
CommonVBSPropertyArea property (Page 2196) 
GlobalColorScheme property (Page 2264) 
LayerDecluttering Property (Page 2296) 
Layers Property (Page 2297) 
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Modified Property (Page 2341) 
ObjectSizeDecluttering Property (Page 2350) 
PdlProtection property (Page 2364) 
GetDeclutterObjectSize method (Page 1830) 
SetDeclutterObjectSize Method (Page 1886) 
FireConnectionEvents method (Page 1843) 
TransformDisplayCoordinate method (Page 1892) 
TransformPixelCoordinate method (Page 1892) 
FillBackColor property (Page 2231) 


Documents Object (Listing) 


Description 

VBA Object Name 
HMIDocuments 

Usage 


Note 


Use the "ActiveDocument" property if you wish to refer to the active picture. 
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Use the Documents property to return the Documents listing. In the following example the 
names of all open pictures are output: 


Sub ShowDocuments () 

'VBA238 

Dim colDocuments As Documents 

Dim objDocument As Document 

Set colDocuments = Application.Documents 
For Each objDocument In colDocuments 
sgBox objDocument .Name 

ext objDocument 

End Sub 


Use the Add method to add a new Document object to the Documents listing. In the following 
example a new picture is created: 


Sub AddNewDocument () 

"VBA239 

Dim objDocument As Document 

Set objDocument = Application.Documents.Add 
End Sub 


See also 
Add Method (Page 1786) 
Document Object (Page 1949) 
SaveAll Method (Page 1880) 
Open Method (Page 1867) 
CloseAll Method (Page 1819) 
Close Method (Page 1818) 
VBA Reference (Page 1745) 
Editing Pictures with VBA (Page 1654) 
Parent Property (Page 2359) 
Count Property (Page 2201) 
Application Property (Page 2121) 
ActiveDocument Property (Page 2107) 
Item Property (Page 2283) 
SetOpenContext method (Page 1886) 
ConvertWM method (Page 1822) 
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DotNetControl object 


Description 
Represents the "DotNetControl" object. The DotNetControl object is an element of the following 
listings: 
e HMlObjects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 

VBA Object Name 
HM|IDotNetControl 

Application 
Use the AddDotNetControl method to insert a DotNetControl in a picture. 
In the following example, the ".NETControl" object from the Global Assembly Cache is inserted 
in the active picture. 

"VBA851 


Dim DotNetControl As HMIDotNetControl 

Set DotNetControl = ActiveDocument.HMIObjects.AddDotNetControl ("MyVBAControl", 
"System.Windows.Forms.Label", True,"Assembly=System.Windows.Forms, Version=2.0.0.0, 
Culture=neutral, PublicKeyToken=b77a5c561934e089") 


See also 
AddDotNetControl method (Page 1797) 
Delete Method (Page 1831) 
Application Property (Page 2121) 
Assemblylnfo property (Page 2122) 
ControlType property (Page 2201) 
Events Property (Page 2223) 
GroupParent Property (Page 2268) 
Height Property (Page 2269) 
Layer Property (Page 2293) 
LDTooltipTexts Property (Page 2303) 
Left Property (Page 2305) 
ObjectName Property (Page 2347) 
Operation Property (Page 2353) 
Parent Property (Page 2359) 
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PasswordLevel Property (Page 2362) 
Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
ToolTipText Property (Page 2445) 

Top Property (Page 2446) 

Type Property (Page 2450) 

Visible Property (Page 2551) 

Width Property (Page 2553) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


DynamicDialog Object 


Description 
Represents the Dynamic dialog. You can use the dynamic dialog to make the properties of 
pictures and objects respond dynamically to different value ranges. 
Define the value range with the aid of the ResultType property. 

VBA Object Name 


HM IDynamicDialog 
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Usage 


Use the DynamicDialog object to make an object property dynamic. In the following example 
the radius of a circle will be dynamically configured using the Dynamic dialog, a tag name will 
be assigned and three analog value ranges will be created: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA240 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 

-ResultType = hmiResultTypeAnalog 

.Trigger.VariableTriggers.Add "NewDynamic2", hmiVariableCycleType 5s 
-AnalogResultInfos.Add 50, 40 

-AnalogResultInfos.Add 100, 80 

-AnalogResultInfos.ElseCase = 100 

End With 

End Sub 


See also 
Delete Method (Page 1831) 
ConvertToScript Method (Page 1820) 
CheckSyntax Method (Page 1817) 
VariableStateValues Property (Page 2546) 
VariableStateChecked Property (Page 2545) 
Trigger Property (Page 2449) 
SourceCode Property (Page 2424) 
ScriptType Property (Page 2407) 
ResultType Property (Page 2399) 
Parent Property (Page 2359) 
Compiled Property (Page 2197) 
BitResultInfo Property (Page 2149) 
BinaryResultInfo Property (Page 2147) 
Application Property (Page 2121) 
AnalogResultInfos Property (Page 2118) 
Prototype Property (Page 2389) 
QualityCodeStateChecked Properties (Page 2390) 
QualityCodeStateValues Property (Page 2392) 
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UsedLanguage property (Page 2464) 
VariablesExist Property (Page 2544) 
VariableStateT ype Property (Page 2546) 
ConvertToVBScript method (Page 1821) 


Ellipse Object 
Description 
Represents the "Ellipse" object. The Ellipse object is an element of the following listings: 
e HMlObjects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 
e HM|DefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 
VBA Object Name 
HMIEllipse 
Usage 


Use the Add method to create a new "Ellipse" object in a picture: 


Sub AddEllipse () 

"VBA241 

Dim objEllipse As HMIEllipse 

Set objEllipse = ActiveDocument.HMIObjects.AddHMIObject ("Ellipse", "HMIEllipse") 
End Sub 
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Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditEllipse() 

"VBA242 

Dim objEllipse As HMIEllipse 

Set objEllipse = ActiveDocument.HMIObjects ("Ellipse") 
objEllipse.BorderColor = RGB(255, 0, 0) 

End Sub 


Use "Selection"(Index) to return an object from the Selection listing. 


Sub ShowNameOfFirstSelectedObject () 

"VBA243 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name from the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
Fillinglndex Property (Page 2233) 
SelectedObjects object (Listing) (Page 2060) 
HM|Objects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
AddHMlObject Method (Page 1801) 
VBA Reference (Page 1745) 
Editing Objects with VBA (Page 1660) 
Width Property (Page 2553) 
Visible Property (Page 2551) 
Top Property (Page 2446) 
ToolTipText Property (Page 2445) 
RadiusWidth Property (Page 2395) 
RadiusHeight Property (Page 2394) 
PasswordLevel Property (Page 2362) 
Operation Property (Page 2353) 
Left Property (Page 2305) 
Layer Property (Page 2293) 
Height Property (Page 2269) 
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FlashRateBorderColor Property (Page 2249) 
FlashRateBackColor Property (Page 2247) 
FlashBorderColor Property (Page 2240) 
FlashBackColor Property (Page 2239) 
FillStyle Property (Page 2235) 

Filling Property (Page 2232) 

FillColor Property (Page 2231) 
BorderWidth Property (Page 2161) 
BorderStyle Property (Page 2160) 
BorderFlashColorOn Property (Page 2159) 
BorderFlashColorOff Property (Page 2157) 
BorderColor Property (Page 2153) 
BorderBackColor Property (Page 2152) 
BackFlashColorOn Property (Page 2139) 
BackFlashColorOff Property (Page 2138) 
BackColor Property (Page 2131) 
Application Property (Page 2121) 

Events Property (Page 2223) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 
Properties Property (Page 2388) 

Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 

Type Property (Page 2450) 
DrawlinsideFrame property (Page 2218) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 
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EllipseArc Object 


Represents the "Ellipse Arc" object. The EllipseArc object is an element of the following listings: 


Description 
e@ HM Objects: Contains all objects of a picture. 
e@ Selection: Contains all selected objects of a picture. 
e HM DefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 
VBA Object Name 
HMIEllipseArc 
Usage 


Use the Add method to create a new "Ellipse Arc" object in a picture: 


Sub AddEllipseArc() 


"VBA244 


Set objl 
End Sub 


Dim objEllipseArc As HMIEllipseArc 
BllipseArc = ActiveDocument.HMIObjects.AddHMIObject ("EllipseArc", 


"HMIE1LlipseArc") 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 


case identifies the object by name: 


Sub Edi 


tEllipseArc() 


"VBA245 


Set obj! 


End Sub 


1960 


Dim objEllipseArc As HMIE1llipseArc 


EllipseArc = ActiveDocument.HMIObjects ("I 


objEllipseArc.BorderColor = RGB(255, 0, 0) 


EllipseArc") 
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Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

"VBA246 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name from the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


Use the "HMIDefaultObjects(Index)" to return an object from the HMIDefaultObjects Listing: 


Sub EditDefaultPropertiesOfEllipseArc() 

"VBA247 

Dim objEllipseArc As HMIE1llipseArc 

Set objEllipseArc = Application. DefaultHMIObjects ("HMIEllipseArc") 
objEllipseArc.BorderColor = RGB(255, 255, 0) 

"create new "EllipseArc"-object 

Set objEllipseArc = ActiveDocument.HMIObjects.AddHMIObject ("EllipseArc2", "HMIEllipseArc") 
End Sub 


See also 
ToolTipText Property (Page 2445) 
SelectedObjects object (Listing) (Page 2060) 
HM|lObjects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
AddHMlObject Method (Page 1801) 
VBA Reference (Page 1745) 
Editing Objects with VBA (Page 1660) 
Width Property (Page 2553) 
Visible Property (Page 2551) 
Top Property (Page 2446) 
StartAngle Property (Page 2426) 
RadiusWidth Property (Page 2395) 
RadiusHeight Property (Page 2394) 
PasswordLevel Property (Page 2362) 
Operation Property (Page 2353) 
Left Property (Page 2305) 
Layer Property (Page 2293) 
Height Property (Page 2269) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 1961 


VBA for Automated Configuration 


3.6 VBA Reference 


1962 


FlashRateBorderColor Property (Page 2249) 


FlashBorderColor Property (Page 2240) 
EndAngle Property (Page 2222) 
BorderWidth Property (Page 2161) 
BorderStyle Property (Page 2160) 
BorderFlashColorOn Property (Page 2159) 
BorderFlashColorOff Property (Page 2157) 
BorderColor Property (Page 2153) 
BorderBackColor Property (Page 2152) 
Application Property (Page 2121) 

Events Property (Page 2223) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 

Parent Property (Page 2359) 

Properties Property (Page 2388) 

Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 

Type Property (Page 2450) 
DrawlnsideFrame property (Page 2218) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 
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EllipseSegment Object 


Description 
Represents the "Ellipse Segment" object. The EllipseSegment object is an element of the 
following listings: 
e@ HM Objects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 
e HM DefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 
VBA Object Name 
HMIEllipseSegment 
Usage 


Use the Add method to create a new "Ellipse Segment" object in a picture: 


Sub AddEllipseSegment () 
'VBA248 
Dim objEllipseSegment As HMIE1llipseSegment 

Set objEllipseSegment = ActiveDocument.HMIObjects.AddHMIObject ("EllipseSegment", 
"HMIELlLipseSegment") 

End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditEllipseSegment () 

"VBA249 

Dim objEllipseSegment As HMIE1llipseSegment 

Set objEllipseSegment = ActiveDocument.HMIObjects ("EllipseSegment") 
objEllipseSegment.BorderColor = RGB(255, 0, 0) 

End Sub 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 1963 


VBA for Automated Configuration 


3.6 VBA Reference 


Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 


"VBA250 


"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 


"Get the name from the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 


End Sub 


See also 


1964 


ToolTipText Property (Page 2445) 
BackFlashColorOn Property (Page 2139) 
SelectedObjects object (Listing) (Page 2060) 
HMlObjects Object (Listing) (Page 1990) 


HMIDefaultObjects Object (Listing) (Page 1985) 


AddHMlObject Method (Page 1801) 

VBA Reference (Page 1745) 

Editing Objects with VBA (Page 1660) 
Width Property (Page 2553) 

Visible Property (Page 2551) 

Top Property (Page 2446) 

StartAngle Property (Page 2426) 
RadiusWidth Property (Page 2395) 
RadiusHeight Property (Page 2394) 
PasswordLevel Property (Page 2362) 
Operation Property (Page 2353) 

Left Property (Page 2305) 

Layer Property (Page 2293) 

Height Property (Page 2269) 
FlashRateBorderColor Property (Page 2249) 
FlashRateBackColor Property (Page 2247) 
FlashBorderColor Property (Page 2240) 
FlashBackColor Property (Page 2239) 
FillStyle Property (Page 2235) 

Fillinglndex Property (Page 2233) 
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Filling Property (Page 2232) 

FillColor Property (Page 2231) 

EndAngle Property (Page 2222) 
BorderWidth Property (Page 2161) 
BorderStyle Property (Page 2160) 
BorderFlashColorOn Property (Page 2159) 
BorderFlashColorOff Property (Page 2157) 
BorderColor Property (Page 2153) 
BorderBackColor Property (Page 2152) 
BackFlashColorOff Property (Page 2138) 
BackColor Property (Page 2131) 
Application Property (Page 2121) 

Events Property (Page 2223) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 

Parent Property (Page 2359) 

Properties Property (Page 2388) 

Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 

Type Property (Page 2450) 
DrawlnsideFrame property (Page 2218) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 
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Event Object 

Description 
Represents an event that triggers one or more actions in Runtime (e.g. a direct connection). 
An event can be configured onto an object and a property. 

VBA Object Name 
HMlEvent 

Usage 


Use the AddAction method to configure an action on an event. In this example a C action is 
to be triggered in the event of a change of radius in Runtime: 


Sub AddActionToPropertyTypeCScript () 
"VBA251 
Dim objEvent As HMIEvent 

Dim objCScript As HMIScriptInfo 

Dim objCircle As HMICircle 

"Create circle in the picture. If property "Radius" is changed, 

"a C-action is added: 

Set objCircle = ActiveDocument .HMIObjects.AddHMIObject ("Circle AB", "HMICircle") 
Set objEvent = objCircle.Radius.Events (1) 

Set objCScript = objEvent.Actions.AddAction (hmiActionCreationTypeCScript) 

End Sub 


See also 
Application Property (Page 2121) 
Delete Method (Page 1831) 
AddAction Method (Page 1794) 
VBA Reference (Page 1745) 
Parent Property (Page 2359) 
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EventType Property (Page 2225) 
Actions Property (Page 2106) 
EventName property (Page 2225) 


Events Object (Listing) 


Description 


3.6 VBA Reference 


A listing of the Event objects that represent all the events configured onto an object. Use the 
Item method to define the event that is intended to be configured: 


e You configure an action on a property with VBA by using the "Events(1)" property, where 
the index "1" stands for the event "Upon change": 


e Toconfigure an action onto an object with the aid of VBA, use the "Events(Index)" property, 
where "Index" stands for the trigger event (see table): 


Index 


EventType (depending upon the object used) 
hmiEventTypeNotDefined 


hmiEventTypeMouseClick 


hmiEventTypeMouseLButtonDown 


hmiEventTypeMouseLButtonUp 


hmiEventTypeMouseRButtonDown 


hmiEventTypeMouseRButtonUp 


hmiEventTypeKeyboardDown 
hmiEventTypeKeyboardUp 


hmiEventTypeFocusEnter 


hmiEventTypeObjectChange 


>S>/O;/OINIO/A!R]/wW]hM]->]o 


oO 


hmiEventTypePictureOpen 


VBA Object Name 
HMlEvents 
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Usage 


Use the Item method to return an individual Event object. In this example the event names 
and event types of all objects in the active pictures are put out. In order for this example to 
work, insert some objects into the active picture and configure different events. 


Sub ShowEventsOfAllObjectsInActiveDocument () 
"VBA252 

Dim colEvents As HMIEvents 

Dim objEvent As HMIEvent 

Dim iMax As Integer 

Dim ilndex As Integer 

Dim iAnswer As Integer 

Dim strEventName As String 

Dim strObjectName As String 

Dim varEventType As Variant 


iIndex = 1 
iMax = ActiveDocument.HMIObjects.Count 
For iIndex = 1 To iMax 
Set colEvents = ActiveDocument.HMIObjects (iIndex) .Events 
strObjectName = ActiveDocument.HMIObjects (iIndex) .ObjectNam 
For Each objEvent In colEvents 
strEventName = objEvent.EventNam 
varEventType = objEvent.EventTyp 
iAnswer = MsgBox("Objectname: " & strObjectName & vbCrLf & "Eventtype: " & varEventType & 
vbCrLf & "Eventname: " & strEventName, vbOKCancel1) 
If vbCancel = iAnswer Then Exit For 
Next objEvent 
If vbCancel = iAnswer Then Exit For 
Next iIndex 
End Sub 
See also 
Item Method (Page 1859) 
VBA Reference (Page 1745) 
Parent Property (Page 2359) 
Count Property (Page 2201) 
Application Property (Page 2121) 
ExternalShapelnfo object 
Description 


Is used for internal purposes in Graphics Designer. 
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FaceplateObject object 


Description 


HM|IDefaultObjects 
HMlIObjects 


Selection 


FaceplateObject 


Represents the "faceplate instance" object. The FaceplateObject object is an element of the 
following lists: 


e@ HM Objects: Contains all objects of a picture. 
® Selection: Contains all selected objects of a picture. 


e HMIDefaultObjects: Contains the default property values of all default, smart, window and 
tube objects. 


VBA object name 
HMIFaceplateObject 


Usage 


Use the Add method to create a new "faceplate instance" object in a picture: 


Sub AddFaceplateInstance () 


"VBA826 

Dim objFaceplateInstance As HMIFaceplateObject 

Set objFaceplateInstance = ActiveDocument.HMIObjects.AddHMIObject ("faceplate instance", 
"HMI FaceplateObject") 

objFaceplateInstance.Properties.Item(3).value = "Faceplatel.fpt" 

End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditFaceplatelInstance() 

"'VBA827 

Dim objFaceplateInstance As HMIFaceplateObject 

Set objFaceplateInstance = ActiveDocument.HMIObjects ("faceplate instance") 
objFaceplateInstance.visible = True 

End Sub 
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Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 


"VBA828 


"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 


"Get the name from the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 


End Sub 


See also 


1970 


ObjectName Property (Page 2347) 
Layer Property (Page 2293) 

Left Property (Page 2305) 

Top Property (Page 2446) 

Width Property (Page 2553) 

Height Property (Page 2269) 
Operation Property (Page 2353) 
PasswordLevel Property (Page 2362) 
Visible Property (Page 2551) 
ToolTipText Property (Page 2445) 
ScalingMode property (Page 2405) 
FaceplateType property (Page 2228) 
Delete Method (Page 1831) 

Destroy Method (Page 1835) 
Application Property (Page 2121) 
Events Property (Page 2223) 
GroupParent Property (Page 2268) 
InheritState property (Page 2278) 
LDTooltipTexts Property (Page 2303) 
Parent Property (Page 2359) 
Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Type Property (Page 2450) 
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ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


FaceplateObjects object 


Description 

A listing of the HMIFaceplateObject objects that represent all faceplate objects in the picture. 
VBA Object Name 

HMIFaceplateObjects 
See also 


Parent Property (Page 2359) 
OriginalPropertyName property (Page 2357) 


FaceplateProperty object 


Description 


Represents the property of a faceplate object. In the case of the FaceplateProperty object, the 
use of the Value property is set as the default. For this reason you can use the following 
notation, for example, to assign a new value to an object property: 


<FaceplateObject>.<FaceplateProperty> = <Value> 


You can use the "Dynamic" property to make an object property dynamic with VBA. Use the 
"Events" listing to configure actions with VBA. 


See also 
CreateDynamic Method (Page 1828) 
DeleteDynamic Method (Page 1833) 
Application Property (Page 2121) 
DisplayName Property (Page 2214) 
Dynamic Property (Page 2218) 
Events Property (Page 2223) 
IsDynamicable Property (Page 2280) 
LDFonts Property (Page 2298) 
LDTexts Property (Page 2303) 
Name Property (Page 2343) 
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Parent Property (Page 2359) 

Value Property (Page 2469) 
IsPublished property (Page 2281) 
LDFontsType property (Page 2299) 
ParentCookie property (Page 2362) 


Folderltem Object 


Description 


Represents a folder or object in the Components Library. A Folderltem object of the "Folder" 
type is an element of the Folderltems listing. A Folderltem object of the "Item" type is an element 
of the Folder listing. 


VBA Object Name 
HMIFolderltem 


Usage 


Use the Folderltems property to return the Folderltems listing. In the following example the 
names of folders in the "Global Library will be output: 


Sub ShowFolderItemsOfGlobalLibrary () 

"VBA253 

Dim colFolderItems As HMIFolderItems 

Dim objFolderItem As HMIFolderItem 

Set colFolderItems = Application.SymbolLibraries(1).FolderItems 
For Each objFolderItem In colFolderItems 

sgBox objFolderItem.Name 

Next objFolderItem 

End Sub 
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Use the CopyToClipboard method to copy a "Folderltem" object of the "Item" type to the 
clipboard. In the following example the object "PC" will be copied to the clipboard. 


Sub CopyFolderItemToClipboard() 

"VBA254 

Dim objGlobalLib As HMISymbolLibrary 

Set objGlobalLib = Application.SymbolLibraries (1) 

objGlobalLib.FolderItems ("Folder2") .Folder ("Folder2") .Folder.Item("Object1") .CopyToClipboa 
rd 

End Sub 


See also 
Type Property (Page 2450) 
Folderltems Object (Listing) (Page 1973) 
Delete Method (Page 1831) 
CopyToClipboard Method (Page 1824) 
How to paste an object from the object library into a picture with VBA (Page 1652) 
How to edit the component library with VBA (Page 1649) 
VBA Reference (Page 1745) 
Accessing the component library with VBA (Page 1646) 
Parent Property (Page 2359) 
Name Property (Page 2343) 
LDNames Property (Page 2301) 
Folder Property (Page 2252) 
Application Property (Page 2121) 
DisplayName Property (Page 2214) 
Pathname Property (Page 2364) 


Folderltems Object (Listing) 


Description 
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A listing of the Folderltem objects that represent all the folders and objects in the Components 
Library. 


VBA Object Name 
HMIFolderltems 


Usage 


Use the Folderltems property to return the Folderltems listing. In the following example the 
names of folders in the "Global Library will be output: 


Sub ShowFolderItemsOfGlobalLibrary () 

"VBA255 

Dim colFolderItems As HMIFolderItems 

Dim objFolderItem As HMIFolderItem 

Set colFolderItems = Application.SymbolLibraries(1).FolderItems 
For Each objFolderItem In colFolderItems 

sgBox objFolderItem.Name 

ext objFolderItem 

End Sub 


Use the AddFolder method, for instance, to create a new folder in the Components Library. In 
the following example the folder "Project Folder" will be created in the "Project Library": 


Sub AddNewFolderToProjectLibrary () 

"VBA256 

Dim objProjectLib As HMISymbolLibrary 

Set objProjectLib = Application.SymbolLibraries (2) 
obj ProjectLib.FolderItems.AddFolder ("My Folder") 
End Sub 


See also 
Addltem Method (Page 1802) 
SymbolLibrary Object (Page 2074) 
Folderltem Object (Page 1972) 
AddFromClipboard Method (Page 1799) 
AddFolder Method (Page 1798) 
How to paste an object from the object library into a picture with VBA (Page 1652) 
How to edit the component library with VBA (Page 1649) 
VBA Reference (Page 1745) 
Accessing the component library with VBA (Page 1646) 
Parent Property (Page 2359) 
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Count Property (Page 2201) 

Application Property (Page 2121) 
FindByDisplayName Method (Page 1842) 
Item Property (Page 2283) 


GraphicObject Object 


Description 


Represents the object called "Graphic Object". The GraphicObject object is an element of the 
following listings: 


@ Objects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 


e HM|DefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 


VBA Object Name 
HM GraphicObject 


Usage 


Use the Add method to create a new "Graphic Object" object in a picture: 


Sub AddGraphicObject () 

"VBA257 

Dim objGraphicObject As HMIGraphicObject 

Set objGraphicObject = ActiveDocument.HMIObjects.AddHMIObject ("Graphic-Object", 
"HMIGraphicObject") 

End Sub 
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Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditGraphicObject () 

"VBA258 

Dim objGraphicObject As HMIGraphicObject 

Set objGraphicObject = ActiveDocument.HMIObjects ("Graphic-Object") 
objGraphicObject.BorderColor = RGB(255, 0, 0) 

End Sub 


Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

"VBA259 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name of the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
Left Property (Page 2305) 
SelectedObjects object (Listing) (Page 2060) 
HM|Objects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
AddHMlObject Method (Page 1801) 
VBA Reference (Page 1745) 
Editing Objects with VBA (Page 1660) 
Width Property (Page 2553) 
Visible Property (Page 2551) 
Top Property (Page 2446) 
ToolTipText Property (Page 2445) 
PicUseTransColor Property (Page 2377) 
PictureName Property (Page 2373) 
PicTransColor Property (Page 2371) 
PicReferenced Property (Page 2370) 
PasswordLevel Property (Page 2362) 
Operation Property (Page 2353) 
Name Property (Page 2343) 
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Layer Property (Page 2293) 

Height Property (Page 2269) 
FlashRateBorderColor Property (Page 2249) 
FlashRateBackColor Property (Page 2247) 
FlashBorderColor Property (Page 2240) 
FlashBackColor Property (Page 2239) 
FillStyle Property (Page 2235) 

Fillinglndex Property (Page 2233) 

Filling Property (Page 2232) 

FillColor Property (Page 2231) 
BorderWidth Property (Page 2161) 
BorderStyle Property (Page 2160) 
BorderFlashColorOn Property (Page 2159) 
BorderFlashColorOff Property (Page 2157) 
BorderColor Property (Page 2153) 
BorderBackColor Property (Page 2152) 
BackFlashColorOn Property (Page 2139) 
BackFlashColorOff Property (Page 2138) 
BackColor Property (Page 2131) 
Application Property (Page 2121) 

Events Property (Page 2223) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 

Parent Property (Page 2359) 

Properties Property (Page 2388) 

Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 

Type Property (Page 2450) 
DrawlnsideFrame property (Page 2218) 
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ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


Group Object 

Description 
Represents the object called "Group Object". The Group Object is an element of the following 
listings: 
e@ HM Objects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 
A group object is created from the objects selected in a picture. The objects in the Group Object 
are also saved in the "GroupedHMlIObjects" listing and index numbers are newly allocated. 
You have unrestricted access to the properties of all objects in the Group Object. 
Further information regarding group objects can be found in the WinCC documentation under 
"Group Object". 

VBA Object Name 
HMIGroup 

Usage 


Use the CreateGroup Method with the Selection listing to create a new "Group Object" object 
in a picture: 


Sub DoCreateGroup () 

"VBA260 

Dim objGroup As HMIGroup 

Set objGroup = ActiveDocument.Selection.CreateGroup 
objGroup.ObjectName = "Group-Object" 

End Sub 


Use the following methods to edit an existing Group Object: 
e@ Methode "Add(Index)": Adds a new object to the group object. 


e Methode "Remove(Index)": Removes a object from the group object. 
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e@ "UnGroup()" method: Ungroups the group object (ungroup). 
e "Delete()" Method: Deletes the group object and the objects that it contains. 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditGroup () 

"VBA261 

Dim objGroup As HMIGroup 

Set objGroup = ActiveDocument.HMIObjects ("Group-Object") 
sgBox objGroup.ObjectName 

End Sub 


See also 
SelectedObjects object (Listing) (Page 2060) 
HMlObjects Object (Listing) (Page 1990) 
GroupedObjects Object (Listing) (Page 1983) 
Ungroup Method (Page 1892) 
Remove Method (Page 1871) 
Delete Method (Page 1831) 
Add Method (GroupedObjects Listing) (Page 1791) 
How to Edit Objects in Group Objects Using VBA (Page 1679) 
How to Edit the Group Objects Using VBA (Page 1676) 
VBA Reference (Page 1745) 
Group Objects (Page 1674) 
Editing Objects with VBA (Page 1660) 
Application Property (Page 2121) 
Events Property (Page 2223) 
GroupParent Property (Page 2268) 
GroupedHMlObjects Property (Page 2269) 
Height Property (Page 2269) 
Layer Property (Page 2293) 
LDTooltipTexts Property (Page 2303) 
Left Property (Page 2305) 
ObjectName Property (Page 2347) 
Operation Property (Page 2353) 
Parent Property (Page 2359) 
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PasswordLevel Property (Page 2362) 
Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
ToolTipText Property (Page 2445) 

Top Property (Page 2446) 

Type Property (Page 2450) 

Visible Property (Page 2551) 

Width Property (Page 2553) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


GroupDisplay Object 


Description 


Represents the "Group Display" object. The GroupDisplay object is an element of the following 
listings: 


@ Objects: Contains all objects of a picture. 


@ Selection: Contains all selected objects of a picture. 


VBA Object Name 
HM |GroupDisplay 
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Usage 


Use the Add method to create a new "Group Display" object in a picture: 


Sub AddGroupDisplay() 

"VBA262 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("Groupdisplay", 
"HMTGroupDisplay") 

End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditGroupDisplay () 

"VBA263 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects ("Groupdisplay") 
objGroupDisplay.BackColor = RGB(255, 0, 0) 

End Sub 


Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

"VBA264 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name from the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
MCText Property (Page 2336) 
Height Property (Page 2269) 
SelectedObjects object (Listing) (Page 2060) 
HMlObjects Object (Listing) (Page 1990) 
AddHM Object Method (Page 1801) 
VBA Reference (Page 1745) 
Editing Objects with VBA (Page 1660) 
Width Property (Page 2553) 
Visible Property (Page 2551) 
UserValue1 Property (Page 2466) 
Top Property (Page 2446) 
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1982 


ToolTipText Property (Page 2445) 
SignificantMask Property (Page 2419) 
SameSize Property (Page 2403) 
Relevant Property (Page 2398) 
PasswordLevel Property (Page 2362) 
Operation Property (Page 2353) 
MessageClass Property (Page 2339) 
MCGUTextFlash Property (Page 2327) 
MCGUTextColorOn Property (Page 2326) 
MCGUTextColorOff Property (Page 2326) 
MCGUBackFlash Property (Page 2325) 
MCGUBackColorOn Property (Page 2324) 
MCGUBackColorOff-Eigenschaft (Page 2324) 
LockText Property (Page 2316) 
LockTextColor Property (Page 2317) 
LockStatus Property (Page 2315) 
LockBackColor Property (Page 2313) 

Left Property (Page 2305) 

Layer Property (Page 2293) 
FontUnderline Property (Page 2259) 
FontSize Property (Page 2258) 
FontName Property (Page 2257) 
Fontltalic Property (Page 2257) 

FontBold Property (Page 2256) 
FlashRate Property (Page 2246) 
Button1..8Width property (Page 2166) 
BackColor Property (Page 2131) 
BackBorderWidth Property (Page 2131) 
AlignmentTop Property (Page 2118) 
AlignmentLeft Property (Page 2117) 
Application Property (Page 2121) 

Events Property (Page 2223) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
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LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 
Parent Property (Page 2359) 

Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 
Type Property (Page 2450) 
Button1..8MessageClasses (Page 2166) 
UseGlobalAlarmClasses property (Page 2465) 
UseGlobalSettings property (Page 2466) 
CollectValue property (Page 2182) 
EventQuitMask property (Page 2222) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


GroupedObjects Object (Listing) 


Description 


A listing of the HMlObject objects that represent all the objects in the group object. 


VBA Object Name 
HMIGroupedObjects 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 1983 


VBA for Automated Configuration 
3.6 VBA Reference 


Usage 


Use the GroupedHMl|Objects property to return the GroupedObjects listing. In the following 
example all the objects in the first group object are output in the active picture. The group 
object called "Group1" must first have been created: 


Sub ShowGroupedObjectsOfFirstGroup () 

"VBA265 

Dim colGroupedObjects As HMIGroupedObjects 

Dim objObject As HMIObject 

Set colGroupedObjects = ActiveDocument.HMIObjects ("Groupl") .GroupedHMIObjects 
For Each objObject In colGroupedObjects 

SgBox objObject.ObjectNam 

Next objObject 

End Sub 


Use the Remove method, for instance, to remove an object from the group object. In the 
following example the first object will be removed from the group object called "Group1": 


Sub RemoveObjectFromGroup () 

"VBA266 

Dim objGroup As HMIGroup 

Set objGroup = ActiveDocument.HMIObjects ("Group1") 
objGroup.GroupedHMIObjects.Remove (1) 

End Sub 


See also 
Group Object (Page 1978) 
Remove Method (Page 1871) 
Add Method (GroupedObjects Listing) (Page 1791) 
How to Edit the Group Objects Using VBA (Page 1676) 
VBA Reference (Page 1745) 
Group Objects (Page 1674) 
Parent Property (Page 2359) 
GroupedHMlObjects Property (Page 2269) 
Count Property (Page 2201) 
Application Property (Page 2121) 
Item Property (Page 2283) 
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Description 


A listing of the following HMlObject objects: 


3.6 VBA Reference 


Object VBA object name 
Line HMILine 

Polygon HMIPolygon 
Polyline HMIPolyLine 
Ellipse HMIEllipse 
Circle HM Circle 


Ellipse segment 


HMIEllipseSegment 


Pie segment 


HMIPieSegment 


Ellipse arc 


HMIEllipseArc 


Circular arc 


HM ICircularArc 


Rectangle 


HM Rectangle 


Rounded rectangle 


HM IRoundRectangle 


Application window 


HM|ApplicationWindow 


Screen Window 


HMIPictureWindow 


Static text HMIStaticText 
I/O Field HMIIOField 
Button HM|Button 
Check box HMICheckBox 
Radio box HMIOptionGroup 


Round button 


HM IRoundButton 


Bar 


HMIBarGraph 


Slider object 


HMISlider 


Graphic Object 


HM IGraphicObject 


Status display 


HM|StatusDisplay 


Text list 


HMITextList 


Connector 
Multiple row text 


HM IObjConnection 
HMIMultiLineEdit 


Combo box 


HMIComboBox 


List box 


HMIListBox 


Polygon tube 


HMITubePolyline 


T-piece 


HMITubeTeeObject 
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Object VBA object name 

Double T-piece HM ITubeDoubleTeeObject 

Tube bend HMITubeArcObject 

3D bar HMI3DBarGraph 

Group display HM IGroupDisplay 

Faceplate instance HMIFaceplateObject 
VBA object name 


HMIDefaultObjects 


Usage 


Use the DefaultHMIObjects property to change the default property values of the included 
objects. In this example all the objects contained in the listing will be output: 


Sub ShowDefaultObjects () 

"VBA267 

Dim strType As String 

Dim strName As String 

Dim strMessage As String 

Dim iMax As Integer 

Dim iIndex As Integer 

iMax = Application.DefaultHMIObjects.Count 

iIndex = 1 

For iIndex = 1 To iMax 

With Application.DefaultHMIObjects (iIndex) 

Sstriype = .Type 

strName = .ObjectNam 

strMessage = strMessage & "Element: " & iIndex & " / Objecttype: " & strType & " / 
Objectname: " & strName 

End With 

If 0 = iIndex Mod 10 Then 

sgBox strMessage 

strMessage = "" 

Else 
strMessage = strMessage & vbCrLf & vbCrhLf 

End If 

ext iIndex 

sgBox "Element: " & iIndex & vbCrLf & "Objecttype: " & strType & vbCrLf & "Objectname: " 
& strName 

End Sub 


See also 
Button Object (Page 1921) 
TextList Object (Page 2076) 
StatusDisplay Object (Page 2070) 
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StaticText Object (Page 2067) 

Slider object (Page 2062) 
RoundRectangle Object (Page 2055) 
RoundButton Object (Page 2052) 
Rectangle Object (Page 2049) 
PolyLine Object (Page 2038) 
Polygon Object (Page 2035) 
PieSegment Object (Page 2032) 
PictureWindow Object (Page 2029) 
OptionGroup Object (Page 2025) 
Line Object (Page 2004) 

IOField Object (Page 1992) 
EllipseSegment Object (Page 1963) 
EllipseArc Object (Page 1960) 
Ellipse Object (Page 1957) 
CircularArc Object (Page 1931) 
Circle Object (Page 1928) 

CheckBox Object (Page 1924) 
BarGraph Object (Page 1914) 
ApplicationWindow Object (Page 1911) 
VBA Reference (Page 1745) 

Parent Property (Page 2359) 

Count Property (Page 2201) 
DefaultHMIlObjects Property (Page 2210) 
Application Property (Page 2121) 
Item Property (Page 2283) 
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HMlObject Object 


Description 


Represents an object from the Object Palette of the Graphics Designer. The HMIObject object 
is an element of the following listings: 


e@ HM Objects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 


e HM|DefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 


This object contains the object properties that apply to all standard, smart and Windows objects 
(incl. Width, Height, Top and Left). 


VBA Object Name 
HM|Object 


Usage 


Use HMlObjects(Index), for instance, to return an individual HMlObject object. "For Index you 
can use either the index number or the name of the object. In the following example the name 
of the first object in the active picture is output: 


Sub ShowFirstObjectOfCollection() 
"VBA268 
Dim strName As String 


strName = ActiveDocument.HMIObjects (1) .ObjectName 


MsgBox strName 
End Sub 
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Use the Delete method to remove an object from the HMlObjects listing. In the following 
example the first object in the active picture will be removed: 


Sub DeleteObject () 

"VBA269 

ActiveDocument .HMIObjects (1) .Delete 
End Sub 


See also 
SelectedObjects object (Listing) (Page 2060) 
HM|lObjects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
Delete Method (Page 1831) 
VBA Reference (Page 1745) 
Default objects, Smart objects, Windows objects and Tube objects (Page 1662) 
Editing Objects with VBA (Page 1660) 
Width Property (Page 2553) 
Visible Property (Page 2551) 
Type Property (Page 2450) 
Top Property (Page 2446) 
ToolTipText Property (Page 2445) 
TabOrderAlpha Property (Page 2429) 
TabOrderSwitch Property (Page 2433) 
Selected Property (Page 2412) 
Properties Property (Page 2388) 
PasswordLevel Property (Page 2362) 
Parent Property (Page 2359) 
Operation Property (Page 2353) 
Left Property (Page 2305) 
LDTooltipTexts Property (Page 2303) 
Layer Property (Page 2293) 
Height Property (Page 2269) 
GroupParent Property (Page 2268) 
Events Property (Page 2223) 
Application Property (Page 2121) 
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ObjectName Property (Page 2347) 
ConnectionPoints property (Page 2198) 


HMlObjects Object (Listing) 


Description 
A listing of the HMlObject objects that represent all the objects in the picture. 

VBA Object Name 
HM|Objects 
Note 
The sequence of HMI objects in the HMlObjects list can be altered by adding and/or deleting 
HMI objects. 
The sequence of listing can also change if HMI objects are processed in the current listing. 
This behavior can occur if the Layers property is modified and/or if the methods "SendToBack" 
and "BringToFront" are used. 

Usage 


Use the HMlObjects property to return the HMlObjects listing. In the following example all the 
object names in the active picture are output: 


Sub ShowObjectsOfDocument () 

"VBA270 

Dim colObjects As HMIObjects 

Dim objObject As HMIObject 

Set colObjects = ActiveDocument.HMIObjects 
For Each objObject In colObjects 

SgBox objObject.ObjectNam 

Next objObject 

End Sub 
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Use the AddHMlObject method to create a new object in the picture. In the following example 
a circle will be inserted into the active picture: 


Sub AddCircle() 


"VBA271 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle 1", "HMICircle") 
End Sub 


Use the Find method to search for one or more objects in the picture. In the following example, 
objects of the "HMICircle" type will be searched for in the active picture: 


Sub FindObjectsByType () 

'VBA272 

Dim colSearchResults As HMICollection 

Dim objMember As HMIObject 

Dim iResult As Integer 

Dim strName As String 

Set colSearchResults = ActiveDocument.HMIObjects.Find(ObjectType:="HMICircle") 
For Each objMember In colSearchResults 

iResult = colSearchResults.Count 


strName = objMember.ObjectNam 
sgBox "Found: " & CStr(iResult) & vbCrLf & "Objectname: " & strName 
ext objMember 

End Sub 

See also 


Count Property (Page 2201) 

HMIDefaultObjects Object (Listing) (Page 1985) 

SelectedObjects object (Listing) (Page 2060) 

Find Method (Page 1841) 

AddOLEObject Method (Page 1803) 

AddHM Object Method (Page 1801) 

AddActiveXControl Method (Page 1795) 

How to edit Default objects, Smart objects, Windows objects and Tube objects (Page 1664) 
VBA Reference (Page 1745) 

Default objects, Smart objects, Windows objects and Tube objects (Page 1662) 
Editing Objects with VBA (Page 1660) 

Parent Property (Page 2359) 

Application Property (Page 2121) 

AddDotNetControl method (Page 1797) 
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AddWPF Control method (Page 1806) 
Item Property (Page 2283) 


IOField Object 
Description 
Represents the "I/O Field" object. The |OField object is an element of the following listings: 
@ Objects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 
e HM|DefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 
VBA Object Name 
HMIIOField 
Usage 


Use the Add method to create a new "I/O Field" object in a picture: 


Sub AddIOField() 

"VBA273 

Dim objIOField As HMIIOField 

Set obj1IOField = ActiveDocument.HMIObjects.AddHMIObject ("IO-Field", "HMIIOField") 
End Sub 
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Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditIOField() 

"VBA274 

Dim objIOField As HMIIOField 

Set obj1IOField = ActiveDocument.HMIObjects ("IO-Field") 
obj 1OField.BorderColor = RGB(255, 0, 0) 

End Sub 


Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

"VBA275 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name from the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


Use the "HMIDefaultObjects(Index)" to return an object from the HMIDefaultObjects Listing: 


Sub EditDefaultPropertiesOfIOField() 

"VBA276 

Dim objIOField As HMIIOField 

Set obj1IOField = Application.DefaultHMIObjects ("HMIIOField") 
obj 1OField.BorderColor = RGB(255, 255, 0) 

End Sub 


See also 
LimitMin Property (Page 2311) 
ClearOnNew Property (Page 2181) 
SelectedObjects object (Listing) (Page 2060) 
HM|lObjects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
AddHMlObject Method (Page 1801) 
VBA Reference (Page 1745) 
Editing Objects with VBA (Page 1660) 
Width Property (Page 2553) 
Visible Property (Page 2551) 
Top Property (Page 2446) 
ToolTipText Property (Page 2445) 
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PasswordLevel Property (Page 2362) 
OutputValue Property (Page 2358) 
OutputFormat Property (Page 2357) 
Orientation Property (Page 2356) 
OperationReport Property (Page 2355) 
OperationMessage Property (Page 2354) 
Operation Property (Page 2353) 

LimitMax Property (Page 2310) 

Left Property (Page 2305) 

Layer Property (Page 2293) 

HiddenInput Property (Page 2271) 

Height Property (Page 2269) 
ForeFlashColorOn Property (Page 2262) 
ForeFlashColorOff Property (Page 2261) 
ForeColor Property (Page 2260) 
FontUnderline Property (Page 2259) 
FontSize Property (Page 2258) 

FontName Property (Page 2257) 
Fontltalic Property (Page 2257) 

FontBold Property (Page 2256) 
FlashRateForeColor Property (Page 2251) 
FlashRateBorderColor Property (Page 2249) 
FlashRateBackColor Property (Page 2247) 
FlashForeColor Property (Page 2242) 
FlashBorderColor Property (Page 2240) 
FlashBackColor Property (Page 2239) 
FillStyle Property (Page 2235) 

EditAtOnce Property (Page 2219) 
DataFormat Property (Page 2210) 
CursorControl Property (Page 2206) 
ClearOnError Property (Page 2180) 
BoxType Property (Page 2165) 
BorderWidth Property (Page 2161) 
BorderStyle Property (Page 2160) 
BorderFlashColorOn Property (Page 2159) 
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BorderFlashColorOff Property (Page 2157) 
BorderColor Property (Page 2153) 
BorderBackColor Property (Page 2152) 
BackFlashColorOn Property (Page 2139) 
BackFlashColorOff Property (Page 2138) 
BackColor Property (Page 2131) 
AssumeOnFull Property (Page 2123) 
AssumeOnExit Property (Page 2123) 
AlignmentTop Property (Page 2118) 
AlignmentLeft Property (Page 2117) 
AdaptBorder Property (Page 2111) 
Application Property (Page 2121) 

Events Property (Page 2223) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
InputValue property (Page 2279) 
LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 
Parent Property (Page 2359) 

Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 
Type Property (Page 2450) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 
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L-Q 


LanguageFont Object 


Description 


Contains the font settings for the project language. The LanguageFont object is an element of 
the LanguageFonts listing. 


VBA Object Name 
HMILanguageFont 


Usage 


Use LDFonts(Index) to return an individual LanguageFont object. In the following example a 
Button object will be created and the name of the first configured font will be output: 


Sub ShowFirstObjectOfCollection() 

"VBA277 

Dim strName As String 

Dim objButton As HMIButton 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Button", "“HMITButton") 
strName = objButton.LDFonts(1).Family 

sgBox strName 

End Sub 


Object properties 
The LanguageFont object possesses the following properties: 


See also 
LanguageFonts Object (Listing) (Page 1997) 
VBA Reference (Page 1745) 
Underlined Property (Page 2460) 
Size Property (Page 2419) 
Parent Property (Page 2359) 
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LanguagelD Property (Page 2289) 
Italic Property (Page 2282) 

Family Property (Page 2229) 

Bold Property (Page 2151) 
Application Property (Page 2121) 


LanguageFonts Object (Listing) 


Description 
A listing of the LanguageFont objects that represent all the language-dependent fonts in an 
object. 

VBA Object Name 
HMILanguageFonts 

Usage 


Use the LDFonts property to return the LanguageFonts listing. In the following example the 
language identifiers of the configured fonts will be output: 


Sub ShowLanguageFont () 

'VBA278 

Dim colLanguageFonts As HMILanguageFonts 

Dim objLanguageFont As HMILanguageFont 

Dim objButton As HMIButton 

Dim iMax As Integer 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMTButton") 
Set colLanguageFonts = objButton.LDFonts 

iMax = colLanguageFonts.Count 

For Each objLanguageFont In colLanguageFonts 

sgBox "Planned fonts: " & iMax & vbCrLf & "Language-ID: " & objLanguageFont.LanguageID 
Next objLanguageFont 

End Sub 
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Use the ItemByLcid method to define the language for which it is intended to enter font settings. 
The following example sets the font attributes of a button for French and English. 


Note 


For this example to work, you must already have configured in the languages concerned. 


Sub ExampleForLanguageFonts () 

"VBA279 

Dim colLangFonts As HMILanguageFonts 

Dim objButton As HMIButton 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMTButton") 
objButton.Text = "DefText" 

Set colLangFonts = objButton.LDFonts 


"Adjust fontsettings for french: 
With colLangFonts.ItemByLCID (1036) 
-Family = "Courier New" 

-Bold = True 

-Italic = False 

-Underlined = Tru 

-Size = 12 

End With 
"Adjust fontsettings for english: 
With colLangFonts.ItemByLCID (1033) 
-Family = "Times New Roman" 

-Bold = False 

-Italic = True 

-Underlined = Fals 

-Size = 14 

End With 

End Sub 


See also 
LanguageFont Object (Page 1996) 
ItemByLcid Method (Page 1861) 
Item Method (Page 1859) 
VBA Reference (Page 1745) 
Parent Property (Page 2359) 
Count Property (Page 2201) 
Application Property (Page 2121) 
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LanguageText Object 


Description 


Contains the multilingual labels for an object. The LanguageText object is an element of the 
LanguageTexts listing. 


VBA Object Name 
HMILanguageText 


Usage 


In the following example a German label and an English label will be assigned to the button 
called "myButton": 


Sub AddLanguagesToButton () 
'VBA280 
Dim objLabelText As HMILanguageText 
Dim objButton As HMIButton 


Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMTButton") 
' 


"Add text in actual datalanguage: 
objButton.Text = "Actual-Language Text" 
' 


"Add english text: 


Set objLabelText = ActiveDocument.HMIObjects ("myButton") .LDTexts.Add(1033, "English Text") 
End Sub 


See also 
LanguageTexts Object (Listing) (Page 2000) 
Delete Method (Page 1831) 
VBA Reference (Page 1745) 
Parent Property (Page 2359) 
LanguagelD Property (Page 2289) 
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DisplayText Property (Page 2216) 
Application Property (Page 2121) 


LanguageTexts Object (Listing) 


Description 

A listing of the LanguageText objects that represent all the multilingual texts in an object. 
VBA Object Name 

HMILanguageTexts 
Usage 


Use one of the following properties to return the LanguageTexts listing: 
e LDLabelTexts Property 

e LDNames Property 

e LDStatusTexts Property 

e LDTexts Property 

e LDTooltipTexts Property 


An example showing how to use the LanguageTexts listing can be found in this documentation 
under the heading "LDStatusTexts Property". 
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Use the Add method to add multilingual texts to an object. In the following example a German 


label and an English label will be assigned to the button called "myButton' 


Sub AddLanguagesToButton () 
'VBA281 
Dim objLabelText As HMILanguageText 
Dim objButton As HMIButton 


Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMITButton") 
' 


‘Add text in actual datalanguage: 
objButton.Text = "Actual-Language Text" 
' 


"Add english text: 


Set objLabelText = ActiveDocument.HMIObjects ("myButton") .LDTexts.Add(1033, "English Text") 


End Sub 


See also 
LanguageText Object (Page 1999) 
ItemByLcid Method (Page 1861) 
Item Method (Page 1859) 
VBA Reference (Page 1745) 
Parent Property (Page 2359) 
LDTooltipTexts Property (Page 2303) 
LDTexts Property (Page 2303) 
LDStatusTexts Property (Page 2301) 
LDNames Property (Page 2301) 
LDLabelTexts Property (Page 2299) 
Count Property (Page 2201) 
Application Property (Page 2121) 


Layer Object 


Description 
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Represents one of the 32 layers that are available in the picture. 


VBA Object Name 
HMlLayer 


Usage 


Use the Layer object to define a name and the minimum and maximum zoom for a layer. You 
define the visibility of layers separately by CS and RT layers: 


@ Document Object: Controls the visibility of the RT layers. 


e View Object: Controls the visibility of the RT layers. 


Use the Layers listing to return a Layer object. In the following example the settings for the 


lowest layer are configured in the active picture: 


Sub ConfigureSettingsOfLayer () 
"VBA282 

Dim objLayer As HMILayer 

Set objLayer = ActiveDocument.Layers (1) 
With objLayer 

‘configure "Layer 0" 

-MinZoom = 10 

-MaxZoom = 100 

-Name = "Configured with VBA" 
End With 

End Sub 


See also 
Layers Property (Page 2297) 
VBA Reference (Page 1745) 
Editing Layers with VBA (Page 1657) 
Visible Property (Page 2551) 
Number Property (Page 2345) 
Name Property (Page 2343) 
MinZoom Property (Page 2340) 
MaxZoom Property (Page 2323) 
LDNames Property (Page 2301) 
ActiveLayer Property (Page 2108) 


2002 
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Layers Object (Listing) 


Description 


A listing of the Layer objects that represent the 32 layers in the picture. 


VBA Object Name 
HMlLayer 


Usage 


Use the LayersCS or LayersRT property to return the Layers listing. In the following example 
the layer names in the copy of the active picture will be output: 


Sub ShowLayer () 

"VBA283 

Dim colLayers As HMILayers 
Dim objLayer As HMILayer 
Dim strLayerList As String 
Dim iCounter As Integer 


iCounter = 1 
Set colLayers = ActiveDocument.Layers 
For Each objLayer In colLayers 
If 1 = iCounter Mod 2 And 32 > iCounter Then 
strLayerList = strLayerList & vbCrLf 
ElseIf 11 > iCounter Then 
strLayerList = strLayerList & " " 
Else 
strLayerList = strLayerList & " 7 
End If 
strLayerList = strLayerList & objLayer.Name 
iCounter = iCounter + 1 
Next objLayer 
sgBox strLayerList 
End Sub 
See also 


Layer Object (Page 2001) 
Item Method (Page 1859) 
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VBA Reference (Page 1745) 
Parent Property (Page 2359) 
Count Property (Page 2201) 
Application Property (Page 2121) 


Line Object 
Description 
Represents the "Line" object. The Line object is an element of the following listings: 
@ Objects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 
e HM|DefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 
VBA Object Name 
HMILine 
Usage 


Use the Add method to create a new "Line" object in a picture: 


Sub AddLine() 

"VBA285 

Dim objLine As HMILine 

Set objLine = ActiveDocument.HMIObjects.AddHMIObject ("Linel", "HMILine") 
End Sub 
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Use "HMlObjects"(Index)" to return an object from the HMlObjects listing, where Index in this 
case identifies the object by name: 


Sub EditLine () 

"VBA286 

Dim objLine As HMILine 

Set objLine = ActiveDocument.HMIObjects ("Linel") 
objLine.BorderColor = RGB(255, 0, O) 

End Sub 


Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

'VBA287 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name of the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
AddHMlObject Method (Page 1801) 
BorderBackColor Property (Page 2152) 
SelectedObjects object (Listing) (Page 2060) 
HM|Objects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
VBA Reference (Page 1745) 
Editing Objects with VBA (Page 1660) 
Width Property (Page 2553) 
Visible Property (Page 2551) 
Top Property (Page 2446) 
ToolTipText Property (Page 2445) 
RotationAngle Property (Page 2400) 
ReferenceRotationTop Property (Page 2397) 
ReferenceRotationLeft Property (Page 2396) 
PasswordLevel Property (Page 2362) 
Operation Property (Page 2353) 
Left Property (Page 2305) 
Layer Property (Page 2293) 
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Index Property (Page 2276) 
Height Property (Page 2269) 


FlashRateBorderColor Property (Page 2249) 


FlashBorderColor Property (Page 2240) 
BorderWidth Property (Page 2161) 
BorderStyle Property (Page 2160) 
BorderFlashColorOn Property (Page 2159) 
BorderFlashColorOff Property (Page 2157) 
BorderEndStyle Property (Page 2156) 
BorderColor Property (Page 2153) 
ActualPointTop Property (Page 2110) 
ActualPointLeft Property (Page 2109) 
Application Property (Page 2121) 

Events Property (Page 2223) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 

Parent Property (Page 2359) 

Properties Property (Page 2388) 

Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 

Type Property (Page 2450) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 
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ListBox object 
Description 
| Multiple Objects —! 
HM|IDefaultObjects 
Selection 
Represents the "ListBox" object. The ListBox object is an element of the following listings: 
e@ HMlObjects: Contains all objects of a picture. 
® Selection: Contains all selected objects of a picture. 
e HM DefaultObjects: Contains the default property values of all default, smart, window and 
tube objects. 
VBA object name 
HMIListBox 
Usage 


Use the Add method to create a new "ListBox" object in a picture: 


Sub AddListBox () 

"VBA829 

Dim objListBox As HMIListBox 

Set objListBox = ActiveDocument.HMIObjects.AddHMIObject ("ListBox", "HMIListBox") 
End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditListBox () 

"VBA830 

Dim objListBox As HMIListBox 

Set objListBox = ActiveDocument.HMIObjects ("ListBox") 
obj ListBox.BorderColor = RGB(255, 0, 0) 

End Sub 
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Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 


"VBA831 


"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 


"Get the name from the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 


End Sub 


See also 


2008 


ObjectName Property (Page 2347) 
Layer Property (Page 2293) 

Left Property (Page 2305) 

Top Property (Page 2446) 

Width Property (Page 2553) 

Height Property (Page 2269) 
NumberLines Property (Page 2346) 
ForeColor Property (Page 2260) 
BorderColor Property (Page 2153) 
BorderBackColor Property (Page 2152) 
BackColor Property (Page 2131) 
FillColor Property (Page 2231) 
BorderStyle Property (Page 2160) 
BorderWidth Property (Page 2161) 
FillStyle Property (Page 2235) 
GlobalShadow property (Page 2264) 
FontName Property (Page 2257) 
FontSize Property (Page 2258) 
FontBold Property (Page 2256) 
Fontltalic Property (Page 2257) 
FontUnderline Property (Page 2259) 
AlignmentLeft Property (Page 2117) 
Index Property (Page 2276) 

Text Property (Page 2439) 
Operation Property (Page 2353) 
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PasswordLevel Property (Page 2362) 
Visible Property (Page 2551) 
ToolTipText Property (Page 2445) 
OperationMessage Property (Page 2354) 
OperationReport Property (Page 2355) 
Sellndex property (Page 2414) 

SelText property (Page 2414) 
Application Property (Page 2121) 
Events Property (Page 2223) 
GroupParent Property (Page 2268) 
LDFonts Property (Page 2298) 

LDTexts Property (Page 2303) 
LDTooltipTexts Property (Page 2303) 
Parent Property (Page 2359) 
Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Type Property (Page 2450) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


Menu Object 


Description 


Represents the "User Defined Menu" object. The Menu object is an element of the 
CustomMenus listing. 
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VBA Object Name 
HMIMenu 


Usage 


Use CustomMenus(Index) to return an individual Menu object. "For Index you can use either 
the index number or the name of the object. In order for the following example to work, create 
a user defined menu. For an example of this, please refer to "Creating a New Application- 
Specific Menu" in this documentation. In the following example the name of the first user- 
defined menu in the active picture will be output: 


Sub ShowFirstMenuOfMenucollection () 


"VBA288 

Dim strName As String 

strName = ActiveDocument.CustomMenus (1) .Label 
sgBox strName 

End Sub 


Use the Delete method to remove a "Menu" object from the "CustomMenus" listing. In the 
following example the first user-defined menu in the active picture will be removed: 


Sub DeleteMenu () 

"VBA289 

Dim objMenu As HMIMenu 

Set objMenu = ActiveDocument.CustomMenus (1) 
objMenu. Delete 

End Sub 


See also 
Menus Object (Listing) (Page 2011) 
Delete Method (Page 1831) 
How to Create Picture-specific Menus and Toolbars (Page 1655) 
How to Create a New Application-Specific Menu (Page 1629) 
VBA Reference (Page 1745) 
Creating Customized Menus and Toolbars (Page 1627) 
Visible Property (Page 2551) 
StatusText Property (Page 2426) 
Position Property (Page 2380) 
Parent Property (Page 2359) 
Menultems Property (Page 2337) 
LDStatusTexts Property (Page 2301) 
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LDLabelTexts Property (Page 2299) 
Label Property (Page 2288) 

Key Property (Page 2287) 

Enabled Property (Page 2220) 
Application Property (Page 2121) 


Menus Object (Listing) 


Description 


A listing of the Menu objects that represent all the user-defined menus in the Graphics 
Designer. 


VBA Object Name 
HMIMenus 


Usage 


Use the CustomMenus property to return the Menus listing. In the following example all the 
user-defined menus in the active picture will be output. 


Note 


The Menus listing does not distinguish between application-specific and picture-specific menus 
in the output. 
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Sub ShowCustomMenusOfDocument () 

"VBA290 

Dim colMenus As HMIMenus 

Dim objMenu As HMIMenu 

Dim strMenuList As String 

Set colMenus = ActiveDocument.CustomMenus 
For Each objMenu In colMenus 

strMenuList = strMenuList & objMenu.Label & vbCrLf 
ext objMenu 

sgBox strMenuList 

End Sub 


Use the Application property and the InsertMenu method if you want to create an application- 
specific menu. Create the VBA code in either the "Project Template" document or the "Global 
Template" document. In the following example a user-defined menu called 
"myApplicationMenu" will be created: 


Sub InsertApplicationSpecificMenu() 

"VBA291 

Dim objMenu As HMIMenu 

Set objMenu = Application.CustomMenus.InsertMenu(1, "a Menul", "myApplicationMenu") 
End Sub 


Use the ActiveDocument property and the InsertWMenu method if you want to create a picture- 
specific menu. Create the VBA code in the document called "ThisDocument": In the following 
example a picture-specific menu called "myDocumentMenu'" will be created:; 


Sub InsertDocumentSpecificMenu () 

"VBA292 

Dim objMenu As HMIMenu 

Set objMenu = ActiveDocument.CustomMenus.InsertMenu(1, "d Menul", "myDocumentMenu") 
End Sub 


See also 
Menu Object (Page 2009) 
Item Method (Page 1859) 
InsertMenu Method (Page 1850) 
How to Create Picture-specific Menus and Toolbars (Page 1655) 
How to Create a New Application-Specific Menu (Page 1629) 
VBA Reference (Page 1745) 
Creating Customized Menus and Toolbars (Page 1627) 
Parent Property (Page 2359) 
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Count Property (Page 2201) 
Application Property (Page 2121) 


Menultem Object 


Description 
Represents a menu entry for a user-defined menu in the Graphics Designer. The Menultem 
object is an element of the Menultems listing. 
VBA Object Name 
HMIMenultem 
Usage 
Note 


In order for the examples to work, first create a user-defined menu. For an example of this, 
please refer to "Adding a New Entry to the Menu" in this documentation. 


Use Menultems(Index) to return an individual Menultem object. "For Index you can use either 
the index number or the name of the object. In the following example the first entry in the first 
user-defined menu in the active picture will be output: 


Sub ShowFirstObjectOfCollection() 


"VBA293 

Dim strName As String 

strName = ActiveDocument.CustomMenus (1) .MenuItems(1).Label 
sgBox strName 

End Sub 
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Use the Delete method to remove an object from the "Menultems" listing. In the following 
example the first entry in the first user-defined menu in the active picture will be deleted: 


Sub DeleteMenulItem () 

"VBA294 

ActiveDocument.CustomMenus (1) .MenuItems(1).Delete 
End Sub 


See also 
Parent Property (Page 2359) 
Menultems Object (Listing) (Page 2015) 
Delete Method (Page 1831) 
Configuring Menus and Toolbars (Page 1626) 
How to assign VBA macros to menus and toolbars (Page 1642) 
How to assign help texts to menus and toolbars (Page 1639) 
How to add a new menu entry to a menu (Page 1631) 
VBA Reference (Page 1745) 
Creating Customized Menus and Toolbars (Page 1627) 
Visible Property (Page 2551) 
Tag Property (Page 2434) 
SubMenu Property (Page 2427) 
StatusText Property (Page 2426) 
ShortCut Property (Page 2416) 
Position Property (Page 2380) 
MenultemType Property (Page 2338) 
Macro Property (Page 2320) 
LDStatusTexts Property (Page 2301) 
LDLabelTexts Property (Page 2299) 
Label Property (Page 2288) 
Key Property (Page 2287) 
Icon Property (Page 2275) 
Enabled Property (Page 2220) 
Checked Property (Page 2172) 
Application Property (Page 2121) 
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Menultems Object (Listing) 


Description 


A listing of the Menultem objects that represent all the entries in a user-defined menu. 


Usage 


Note 


In order for the examples to work, first create a user-defined menu. For an example of this, 
please refer to "Adding a New Entry to the Menu" in this documentation. 


Use the Menultems property to return the Menultems listing. In the following example all the 
entries in the first user-defined menu in the active picture will be output: 


Note 


The Menultems listing does not distinguish between an application-specific and a picture- 
specific menu in the output. 


Sub ShowMenulItems () 

"VBA295 

Dim colMenuItems As HMIMenuItems 

Dim objMenuItem As HMIMenuItem 

Dim strItemList As String 

Set colMenuItems = ActiveDocument.CustomMenus (1) .MenuItems 
For Each objMenuItem In colMenuItems 

stritemList = strItemList & objMenultem.Label & vbCrLf 
Next objMenuItem 

sgBox strItemList 

End Sub 
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Use the InsertMenultem method, for instance, to insert an entry into an existing user-defined 
menu. In the following example the picture-specific menu "DocMenu2" will be created in the 
active picture and the menu entry "Menultem1" is inserted: 


Sub InsertMenulItem () 

"VBA296 

Dim objMenu As HMIMenu 

Dim objMenuItem As HMIMenuItem 

Set objMenu = ActiveDocument.CustomMenus.InsertMenu(2, "d Menu2", "DocMenu2") 
Set objMenuItem = objMenu.Menultems.InsertMenultem(1, "m_Item2_1", "MenulItem 1") 
End Sub 


See also 
InsertSubmenu Method (Page 1854) 
Menultem Object (Page 2013) 
InsertSeparator Method (Page 1853) 
InsertMenultem Method (Page 1852) 
How to add a new menu entry to a menu (Page 1631) 
VBA Reference (Page 1745) 
Creating Customized Menus and Toolbars (Page 1627) 
Parent Property (Page 2359) 
Count Property (Page 2201) 
Application Property (Page 2121) 


MultiLineEdit object 


Description 


HM|IDefaultObjects 


HM Objects MultiLineEdit 
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Represents the "MultiLineEdit" object. The MultiLineEdit object is an element of the following 
listings: 


e HMlObjects: Contains all objects of a picture. 
® Selection: Contains all selected objects of a picture. 


e HM|DefaultObjects: Contains the default property values of all default, smart, window and 
tube objects. 


VBA object name 
HMIMultiLineEdit 


Usage 


Use the Add method to create a new "MultiLineEdit" object in a picture: 


Sub AddMultiLineEdit () 
'VBA832 
Dim objMultiLineEdit As HMIMultiLineEdit 

Set objMultiLineEdit = ActiveDocument.HMIObjects.AddHMIObject ("MultiLineEdit", 
"HMIMultiLineEdit") 

End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditMultiLineEdit () 

"VBA833 

Dim objMultiLineEdit As HMIMultiLineEdit 

Set objMultiLineEdit = ActiveDocument.HMIObjects ("MultiLineEdit") 
objMultiLineEdit.BorderColor = RGB(255, 0, 0) 

End Sub 


Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

"VBA834 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name from the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
Layer Property (Page 2293) 
Left Property (Page 2305) 
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BorderColor Property (Page 2153) 
BorderBackColor Property (Page 2152) 
BorderStyle Property (Page 2160) 
BorderWidth Property (Page 2161) 
BackColor Property (Page 2131) 
FontName Property (Page 2257) 
FontSize Property (Page 2258) 
FontBold Property (Page 2256) 
Fontltalic Property (Page 2257) 
FontUnderline Property (Page 2259) 
ForeColor Property (Page 2260) 
AlignmentLeft Property (Page 2117) 
Top Property (Page 2446) 

Width Property (Page 2553) 

Height Property (Page 2269) 

Text Property (Page 2439) 

Operation Property (Page 2353) 
PasswordLevel Property (Page 2362) 
Visible Property (Page 2551) 
ToolTipText Property (Page 2445) 
ObjectName Property (Page 2347) 
GlobalShadow property (Page 2264) 
Application Property (Page 2121) 
GroupParent Property (Page 2268) 
LDFonts Property (Page 2298) 
LDTexts Property (Page 2303) 
LDTooltipTexts Property (Page 2303) 
Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Type Property (Page 2450) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 
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ObjConnection object 


Description 
Represents the "Connector" object. The ObjConnection object is an element of the following 
listings: 
@ Objects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 
Note 
You have read-only access to the properties of the ObjConnection object. 
VBA Object Name 
HMIObjConnection 
Application 
From the properties of the ObjConnection object you can find out which objects are connected. 
Example 


In order for the following example to work you must have connected two objects to the 
connector in the active picture of the Graphics Designer. You can find the Connector object in 
the Graphics Designer in the Object Palette under "Standard Objects". For this example to 
work, give the connector the name "Connector1". 
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In the user-defined menu "Connector Info" you can click on the "Connector Info" entry and 
display the objects connected via the connector: 
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Sub ShowConnectorInfo Menu () 

"VBA297 

Dim objMenu As HMIMenu 

Dim objMenuItem As HMIMenuItem 

Dim strDocName As String 

strDocName = Application.ApplicationDataPath & ActiveDocument.Nam 

Set objMenu = Documents (strDocName) .CustomMenus.InsertMenu(1, "ConnectorMenu", 

"Connector Info") 

Set objMenuItem = objMenu.MenulItems.InsertMenuItem(1, "ShowConnectInfo", "Info Connector") 
End Sub 


Sub 
Dim 


howConnectoriInfo() 

bjConnector As HMIObjConnection 
Start As Integer 

End As Integer 


iS) 
fe) 
Dim i 
i 

Dim strStart As String 
Ss 
Ss 
Ss 
fe) 


Dim 


Dim strEnd As String 

Dim strObjStart As String 

Dim strObjEnd As String 

Set objConnector = ActiveDocument.HMIObjects ("Connectorl") 


iStart = objConnector.BottomConnectedConnectionPoint Index 


iEnd = objConnector.TopConnectedConnectionPointIndex 
strObjStart = objConnector.BottomConnectedObjectNam 
strObjEnd = objConnector.TopConnectedObjectNam 
Select Case iStart 
Case 0 
strStart = "top" 
Case 1 
strStart = "right" 
Case 2 
strStart = "bottom" 
Case 3 
strStart = "left" 
End Select 
Select Case iEnd 
Case 0 
strEnd = "top" 
Case 1 
strEnd = "right" 
Case 2 
strEnd = "bottom" 
Case 3 
strEnd = "left" 
End Select 
sgBox "The selected connector links the objects " & vbCrLf & "'" & strObjStart & "' and '" 
& strObjEnd & "'" & vbCrLf & "Connected points: " & vbCrLf & strObjStart & ": " & strStart 
& vbCrLf & strObjEnd & ": " & strEnd 
End Sub 
Private Sub Document MenulItemClicked (ByVal MenuItem As IHMIMenuItem) 


Select Case MenulItem.Key 
Case "ShowConnectInfo" 
Call ShowConnectorInfo 
End Select 

End Sub 
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See also 
TopConnectedConnectionPointIndex Property (Page 2447) 
TopConnectedObjectName Property (Page 2446) 
BottomConnectedConnectionPointIndex Property (Page 2163) 
BottomConnectedObjectName Property (Page 2162) 
Application Property (Page 2121) 
BorderBackColor Property (Page 2152) 
BorderColor Property (Page 2153) 
BorderEndStyle Property (Page 2156) 
BorderFlashColorOff Property (Page 2157) 
BorderFlashColorOn Property (Page 2159) 
BorderStyle Property (Page 2160) 
BorderWidth Property (Page 2161) 
Events Property (Page 2223) 
FlashBorderColor Property (Page 2240) 
FlashRateBorderColor Property (Page 2249) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
Height Property (Page 2269) 
Layer Property (Page 2293) 
LDTooltipTexts Property (Page 2303) 
Left Property (Page 2305) 
ObjectName Property (Page 2347) 
Operation Property (Page 2353) 
Orientation Property (Page 2356) 
Parent Property (Page 2359) 
PasswordLevel Property (Page 2362) 
Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
ToolTipText Property (Page 2445) 
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Top Property (Page 2446) 
Transparency property (Page 2447) 
Type Property (Page 2450) 

Visible Property (Page 2551) 

Width Property (Page 2553) 
ConnectorType property (Page 2200) 
ConnectionPoints property (Page 2198) 
Display property (Page 2214) 
ConnectorObjects property (Page 2199) 


OLEObject Object 


Description 


Represents the object called "OLE Element". The OLEObject object is an element of the 
following listings: 


@ Objects: Contains all objects of a picture. 


@ Selection: Contains all selected objects of a picture. 


VBA Object Name 
HMIOLEObject 


Usage 


Use the AddOLEObject method to create a new "OLE Element" object in a picture: In the 
following example an OLE Element containing a Wordpad document will be inserted into the 
active picture: 


Sub AddOLEObjectToActiveDocument () 

"VBA298 

Dim objOleObject As HMIOLEObject 

Set objOleObject = ActiveDocument.HMIObjects.AddOLEObject ("Wordpad Document", 
"Wordpad.Document.1") 

End Sub 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 2023 


VBA for Automated Configuration 
3.6 VBA Reference 


Use "HMlObjects(Index)" to return an object from the HMlObjects listing, where "Index" in this 
case identifies the object by name: In this example the X coordinate of the OLE Element 
"Wordpad Document" is set to 140: 


Sub EditOLEObject () 

"VBA299 

Dim objOleObject As HMIOLEObject 

Set objOleObject = ActiveDocument.HMIObjects ("Wordpad Document") 
objOleObject.Left = 140 

End Sub 


Use "Selection(Index)" to return an object from the Selection listing. "For Index you can use 
either the index number or the name of the object. In this example the name of the first selected 
object will be output: 


Sub ShowNameOfFirstSelectedObject () 

"VBA300 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name of the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
How to Create Picture-specific Menus and Toolbars (Page 1655) 
SelectedObjects object (Listing) (Page 2060) 
HM|Objects Object (Listing) (Page 1990) 
Delete Method (Page 1831) 
AddOLEObject Method (Page 1803) 
How to Create an Application-specific Toolbar (Page 1635) 
VBA Reference (Page 1745) 
OLE Objects (Page 1669) 
Application Property (Page 2121) 
Events Property (Page 2223) 
GroupParent Property (Page 2268) 
Height Property (Page 2269) 
Layer Property (Page 2293) 
LDTooltipTexts Property (Page 2303) 
Left Property (Page 2305) 
ObjectName Property (Page 2347) 
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Operation Property (Page 2353) 

Parent Property (Page 2359) 
PasswordLevel Property (Page 2362) 
Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
ToolTipText Property (Page 2445) 

Top Property (Page 2446) 

Type Property (Page 2450) 

Visible Property (Page 2551) 

Width Property (Page 2553) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


OptionGroup Object 


Description 


Represents the "Radio Box" object. The OptionGroup object is an element of the following 
listings: 


@ Objects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 


e HM|IDefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 


VBA Object Name 
HMIOptionGroup 
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Usage 


Use the Add method to create a new "Option Group" object in a picture: 


Sub AddOptionGroup () 

"VBA301 

Dim objOptionGroup As HMIOptionGroup 

Set objOptionGroup = ActiveDocument.HMIObjects.AddHMIObject ("Radio-Box", "HMIOptionGroup") 
End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditOptionGroup () 

"VBA302 

Dim objOptionGroup As HMIOptionGroup 

Set objOptionGroup = ActiveDocument.HMIObjects ("Radio-Box") 
objOptionGroup.BorderColor = RGB(255, 0, 0) 

End Sub 


Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

"VBA303 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name of the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
Left Property (Page 2305) 
BorderStyle Property (Page 2160) 
SelectedObjects object (Listing) (Page 2060) 
HMlObjects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
AddHMlObject Method (Page 1801) 
VBA Reference (Page 1745) 
Editing Objects with VBA (Page 1660) 
Width Property (Page 2553) 
Visible Property (Page 2551) 
Top Property (Page 2446) 
ToolTipText Property (Page 2445) 
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Text Property (Page 2439) 

Process Property (Page 2383) 
PasswordLevel Property (Page 2362) 
Orientation Property (Page 2356) 
OperationMessage Property (Page 2354) 
Operation Property (Page 2353) 

Layer Property (Page 2293) 

Index Property (Page 2276) 

Height Property (Page 2269) 
ForeFlashColorOn Property (Page 2262) 
ForeFlashColorOff Property (Page 2261) 
ForeColor Property (Page 2260) 
FontUnderline Property (Page 2259) 
FontSize Property (Page 2258) 

FontName Property (Page 2257) 

Fontltalic Property (Page 2257) 

FontBold Property (Page 2256) 
FlashRateForeColor Property (Page 2251) 
FlashRateBorderColor Property (Page 2249) 
FlashRateBackColor Property (Page 2247) 
FlashForeColor Property (Page 2242) 
FlashBorderColor Property (Page 2240) 
FlashBackColor Property (Page 2239) 
FillStyle Property (Page 2235) 

Fillinglndex Property (Page 2233) 

Filling Property (Page 2232) 

FillColor Property (Page 2231) 

BoxCount Property (Page 2164) 
BoxAlignment Property (Page 2163) 
BorderWidth Property (Page 2161) 
BorderFlashColorOn Property (Page 2159) 
BorderFlashColorOff Property (Page 2157) 
BorderColor Property (Page 2153) 
BorderBackColor Property (Page 2152) 
BackFlashColorOn Property (Page 2139) 
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BackFlashColorOff Property (Page 2138) 
BackColor Property (Page 2131) 
AlignmentTop Property (Page 2118) 
AlignmentLeft Property (Page 2117) 
AdaptBorder Property (Page 2111) 
Application Property (Page 2121) 
Events Property (Page 2223) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
LDFonts Property (Page 2298) 

LDTexts Property (Page 2303) 
LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 
Parent Property (Page 2359) 

Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 
Type Property (Page 2450) 
WindowsStyle property (Page 2557) 
DrawlnsideFrame property (Page 2218) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 
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PictureWindow Object 


Description 


Represents the "Picture Window" object. The PictureWindow object is an element of the 
following listings: 


@ Objects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 


e HM|DefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 


VBA Object Name 
HM|PictureWindow 


Usage 


Use the Add method to create a new "Picture Window" object in a picture: 


Sub AddPictureWindow () 

'VBA304 

Dim objPictureWindow As HMIPictureWindow 

Set objPictureWindow = ActiveDocument.HMIObjects.AddHMIObject ("PictureWindowl", 
"HMI PictureWindow") 

End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditPictureWindow() 

"VBA305 

Dim objPictureWindow As HMIPictureWindow 

Set objPictureWindow = ActiveDocument.HMIObjects ("PictureWindowl1") 
obj PictureWindow.Sizeable = True 

End Sub 
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Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 


"VBA306 


"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 


"Get th 


End Sub 


See also 


2030 


of the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 


MaximizeButton Property (Page 2322) 
SelectedObjects object (Listing) (Page 2060) 
HM Objects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
AddHMlObject Method (Page 1801) 
VBA Reference (Page 1745) 

Editing Objects with VBA (Page 1660) 
Zoom Property (Page 2559) 
WindowBorder Property (Page 2555) 
Width Property (Page 2553) 

Visible Property (Page 2551) 
UpdateCycle Property (Page 2463) 

Top Property (Page 2446) 

TagPrefix Property (Page 2436) 
Sizeable Property (Page 2421) 
ServerPrefix Property (Page 2416) 
ScrollPositionY Property (Page 2409) 
ScrollPositionX Property (Page 2408) 
ScrollBars Property (Page 2408) 
PictureName Property (Page 2373) 
OnTop Property (Page 2352) 

OffsetTop Property (Page 2351) 
OffsetLeft Property (Page 2350) 
Moveable Property (Page 2342) 

Left Property (Page 2305) 
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Layer Property (Page 2293) 

Height Property (Page 2269) 

CloseButton Property (Page 2182) 
CaptionText Property (Page 2169) 

Caption Property (Page 2168) 

AdaptSize Property (Page 2112) 

AdaptPicture Property (Page 2111) 

Application Property (Page 2121) 

Events Property (Page 2223) 

GroupParent Property (Page 2268) 
IndependentWindow property (Page 2276) 
LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 

Operation Property (Page 2353) 

Parent Property (Page 2359) 

PasswordLevel Property (Page 2362) 
Properties Property (Page 2388) 

Selected Property (Page 2412) 

ToolTipText Property (Page 2445) 

Type Property (Page 2450) 
WindowMonitorNumber property (Page 2556) 
WindowPositionMode property (Page 2556) 
ConnectionPoints property (Page 2198) 
MenuToolBarConfig Property (Page 2339) 
TitleBackColorActiveEnd property (Page 2440) 
TitleBackColorActiveStart property (Page 2440) 
TitleBackColorlInactiveEnd property (Page 2440) 
TitleBackColorlnactiveStart property (Page 2440) 
TitleForeColorActive property (Page 2441) 
TitleForeColorinactive property (Page 2441) 
Pinnable property (Page 2378) 

Pinned property (Page 2378) 
ConnectorObjects property (Page 2199) 
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PieSegment Object 


Description 


Represents the "Pie Segment" object. The PieSegment object is an element of the following 
listings: 


@ Objects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 


e HM|DefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 


VBA Object Name 
HMIPieSegment 


Usage 


Use the Add method to create a new "Pie Segment" object in a picture: 


Sub AddPieSegment () 

'VBA307 

Dim objPieSegment As HMIPieSegment 

Set objPieSegment = ActiveDocument.HMIObjects.AddHMIObject ("PieSegment1", "HMIPieSegment") 
End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditPieSegment () 

'VBA308 

Dim objPieSegment As HMIPieSegment 

Set objPieSegment = ActiveDocument.HMIObjects ("PieSegment1") 
obj PieSegment.BorderColor = RGB(255, 0, 0) 

End Sub 
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Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

"VBA309 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name from the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
Filling Property (Page 2232) 
SelectedObjects object (Listing) (Page 2060) 
HMlObjects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
AddHMObject Method (Page 1801) 
VBA Reference (Page 1745) 
Editing Objects with VBA (Page 1660) 
Width Property (Page 2553) 
Visible Property (Page 2551) 
Top Property (Page 2446) 
ToolTipText Property (Page 2445) 
StartAngle Property (Page 2426) 
Radius Property (Page 2394) 
PasswordLevel Property (Page 2362) 
Operation Property (Page 2353) 
Left Property (Page 2305) 
Layer Property (Page 2293) 
Height Property (Page 2269) 
FlashRateBorderColor Property (Page 2249) 
FlashRateBackColor Property (Page 2247) 
FlashBorderColor Property (Page 2240) 
FlashBackColor Property (Page 2239) 
FillStyle Property (Page 2235) 
Fillinglndex Property (Page 2233) 
FillColor Property (Page 2231) 
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EndAngle Property (Page 2222) 
BorderWidth Property (Page 2161) 
BorderStyle Property (Page 2160) 
BorderFlashColorOn Property (Page 2159) 
BorderFlashColorOff Property (Page 2157) 
BorderColor Property (Page 2153) 
BorderBackColor Property (Page 2152) 
BackFlashColorOn Property (Page 2139) 
BackFlashColorOff Property (Page 2138) 
BackColor Property (Page 2131) 
Application Property (Page 2121) 

Events Property (Page 2223) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 

Parent Property (Page 2359) 

Properties Property (Page 2388) 

Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 

Type Property (Page 2450) 
DrawlnsideFrame property (Page 2218) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 
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Polygon Object 


Description 


Represents the "Polygon" object. The Polygon object is an element of the following listings: 
@ Objects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 


e HMIDefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 


VBA Object Name 
HMIPolygon 


Usage 


Use the Add method to create a new "Polygon" object in a picture: 


Sub AddPolygon () 
"VBA310 
Dim objPolygon As HMIPolygon 


Set objPolygon = ActiveDocument.HMIObjects.AddHMIObject ("Polygon", "HMIPolygon") 
End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditPolygon () 

'VBA311 

Dim objPolygon As HMIPolygon 

Set objPolygon = ActiveDocument.HMIObjects ("Polygon") 
objPolygon.BorderColor = RGB (255, 0, 0) 

End Sub 
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Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 


"VBA312 


"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 


"Get the name from the first object of the selection: 


End Sub 


See also 


2036 


sgBox ActiveDocument.Selection(1) .ObjectName 


ToolTipText Property (Page 2445) 
BorderBackColor Property (Page 2152) 
SelectedObjects object (Listing) (Page 2060) 
HMIObjects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
AddHMlObject Method (Page 1801) 

VBA Reference (Page 1745) 

Editing Objects with VBA (Page 1660) 

Width Property (Page 2553) 

Visible Property (Page 2551) 

Top Property (Page 2446) 

RotationAngle Property (Page 2400) 
ReferenceRotationTop Property (Page 2397) 
ReferenceRotationLeft Property (Page 2396) 
PointCount Property (Page 2379) 
PasswordLevel Property (Page 2362) 
Operation Property (Page 2353) 

Left Property (Page 2305) 

Layer Property (Page 2293) 

Index Property (Page 2276) 

Height Property (Page 2269) 
FlashRateBorderColor Property (Page 2249) 
FlashRateBackColor Property (Page 2247) 
FlashBorderColor Property (Page 2240) 
FlashBackColor Property (Page 2239) 
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FillStyle Property (Page 2235) 
Fillinglndex Property (Page 2233) 

Filling Property (Page 2232) 

FillColor Property (Page 2231) 
BorderWidth Property (Page 2161) 
BorderStyle Property (Page 2160) 
BorderFlashColorOn Property (Page 2159) 
BorderFlashColorOff Property (Page 2157) 
BorderColor Property (Page 2153) 
BackFlashColorOn Property (Page 2139) 
BackFlashColorOff Property (Page 2138) 
BackColor Property (Page 2131) 
ActualPointTop Property (Page 2110) 
ActualPointLeft Property (Page 2109) 
Application Property (Page 2121) 

Events Property (Page 2223) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 

Parent Property (Page 2359) 

Properties Property (Page 2388) 

Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 

Type Property (Page 2450) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 
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PolyLine Object 


Description 


Represents the "Polyline" object. The PolyLine object is an element of the following listings: 
@ Objects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 


e HM|DefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 


VBA Object Name 
HMIPolyLine 


Usage 


Use the Add method to create a new "Polyline" object in a picture: 


Sub AddPolyLine () 

'VBA313 

Dim objPolyLine As HMIPolyLine 

Set objPolyLine = ActiveDocument.HMIObjects.AddHMIObject ("PolyLinel", "HMIPolyLine") 
End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditPolyLine () 

'VBA314 

Dim objPolyLine As HMIPolyLine 

Set objPolyLine = ActiveDocument.HMIObjects ("PolyLinel") 
objPolyLine.BorderColor = RGB(255, 0, 0) 

End Sub 
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Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

"VBA315 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name of the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


Use the "HMIDefaultObjects(Index)" to return an object from the HMIDefaultObjects Listing: 


Sub EditDefaultPropertiesOfPolyLine() 

"VBA316 

Dim objPolyLine As HMIPolyLine 

Set objPolyLine = Application.DefaultHMIObjects ("HMIPolyLine") 
obj PolyLine.BorderColor = RGB(255, 255, 0) 

End Sub 


See also 
HMIDefaultObjects Object (Listing) (Page 1985) 
BorderEndStyle Property (Page 2156) 
SelectedObjects object (Listing) (Page 2060) 
HM|Objects Object (Listing) (Page 1990) 
AddHM Object Method (Page 1801) 
VBA Reference (Page 1745) 
Editing Objects with VBA (Page 1660) 
Width Property (Page 2553) 
Visible Property (Page 2551) 
Top Property (Page 2446) 
ToolTipText Property (Page 2445) 
RotationAngle Property (Page 2400) 
ReferenceRotationTop Property (Page 2397) 
ReferenceRotationLeft Property (Page 2396) 
PointCount Property (Page 2379) 
PasswordLevel Property (Page 2362) 
Operation Property (Page 2353) 
Left Property (Page 2305) 
Layer Property (Page 2293) 
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Index Property (Page 2276) 
Height Property (Page 2269) 


FlashRateBorderColor Property (Page 2249) 


FlashBorderColor Property (Page 2240) 
BorderWidth Property (Page 2161) 
BorderStyle Property (Page 2160) 
BorderFlashColorOn Property (Page 2159) 
BorderFlashColorOff Property (Page 2157) 
BorderColor Property (Page 2153) 
BorderBackColor Property (Page 2152) 
ActualPointTop Property (Page 2110) 
ActualPointLeft Property (Page 2109) 
Application Property (Page 2121) 

Events Property (Page 2223) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 

Parent Property (Page 2359) 

Properties Property (Page 2388) 

Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 

Type Property (Page 2450) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 
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Properties Object (Listing) 


Description 
A listing of the Property objects that represent all the properties of an object. 
VBA Object Name 
HMIProperties 
Usage 


Use the Properties(Index) property in order to return a Property object if you cannot access 
an object property directly. For"Index" you can use either the index number or the VBA property 
name of the object. In the following example the Properties property has to be used to access 


the individual properties of a circle. The circle will be inserted into the picture as an HMIObject 
object: 


Sub AddObject () 


"VBA319 

Dim objObject As HMIObject 

Set objObject = ActiveDocument.HMIObjects.AddHMIObject ("CircleAsHMIObject", "HMICircle") 
, g 


"Standard properties (e.g. "Position") 
objObject.Top = 40 
objObject.Left = 40 
14 


are available every time: 


"Individual properties have to be called using 
"property "Properties": 

objObject.Properties ("FlashBackColor") = True 
End Sub 


See also 
VBA Reference (Page 1745) 
Editing Objects with VBA (Page 1660) 
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Parent Property (Page 2359) 
Count Property (Page 2201) 
Application Property (Page 2121) 
Item Property (Page 2283) 


Property Object 

Description 
Represents the property of an object. In the case of the Property object the use of the Value 
property is set as the default. For this reason you can use the following notation in order for 
example to assign a new value to an object property: 
<Object>.<Property> = <Value> 
You can use the "Dynamic" property in order to make an object property dynamic with VBA. 
Use the "Events" listing in order to configure actions with VBA. 
The Property object is an element of the Properties listing. 

VBA Object Name 
HM|IProperty 

Usage 


Use Properties(Index) to return an individual Property object. For "Index" you can use either 
the index number or the name of the object property. In the following example the name of the 
first property of the Circle object will be output: 


Sub ShowFirstObjectOfCollection() 

"VBA317 

Dim objCircle As HMICircle 

Dim strName As String 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle", “HMICircle") 
strName = objCircle. Properties (1) .Name 

sgBox strName 

End Sub 
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Sub Dynamic 
'VBA318 


loRa 


3.6 VBA Reference 


Use the CreateDynamic method to make an object property dynamic. In the following example 
the "Radius" property of a circle object will be made dynamic with the aid of the tag "Otto", 
which is updated every two seconds: 


diusOfNewCircle () 


Dim objVariableTrigger As HMIVariableTrigger 


Dim objCircl 


Set objCircl 


le A 


s HMICircle 


ActiveDocument.HMIObjects ("Circle") 


Set objVariableTrigger = 
objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeVariableDirect, "NewDynamicl") 


objVariabl 


End Sub 


See also 


Trig 


ger.CycleType = hmiCycleType 2s 


DisplayName Property (Page 2214) 
Properties Object (Listing) (Page 2041) 
DeleteDynamic Method (Page 1833) 
CreateDynamic Method (Page 1828) 
VBA Reference (Page 1745) 

Creating Dynamics with VBA (Page 1686) 
Editing Objects with VBA (Page 1660) 
Value Property (Page 2469) 

Parent Property (Page 2359) 

Name Property (Page 2343) 
IsDynamicable Property (Page 2280) 
Events Property (Page 2223) 

Dynamic Property (Page 2218) 
Application Property (Page 2121) 
IsPublished property (Page 2281) 
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QualityCodeStateValue Object 


Description 


Represents the quality code of a tag which is assigned in the dynamic dialog and used for 
dynamization. 


VBA Object Name 
HMIQualityCodeStateValue 


Object properties 


2044 


The object QualityCodeStateValue has the following properties: 


Application 

Parent 

VALUE_BAD_COMMLUV 
VALUE_BAD_COMMLUV 
VALUE_BAD_CONFERROR 
VALUE_BAD_DEVICE 
VALUE_BAD_MISCSTATES 
VALUE_BAD_NONSPECIFIC 
VALUE_BAD_NOTCONNECTED 
VALUE_BAD_OUTOFSERV 
VALUE_BAD_PROCRELNOM 
VALUE_BAD_PROCRELSUB 
VALUE_HIGHLIMITED 
VALUE_LOWLIMITED 
VALUE_UNCERT_ENGVHIGHLIM 
VALUE_UNCERT_ENGVLOWLIM 
VALUE_UNCERT_ENGVONLIM 
VALUE_UNCERT_INITVAL 
VALUE_UNCERT_LUV 
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See also 


3.6 VBA Reference 


e VALUE_UNCERT_MAINTDEM 

e VALUE_UNCERT_MISCSTATES 

e VALUE_UNCERT_NONSPECIFIC 
e VALUE_UNCERT_PROCRELNOM 
e VALUE_UNCERT_SIMVAL 

e VALUE_UNCERT_SUBSTSET 


e VarName 


VALUE_BAD_CONFERROR Property (Page 2478) 

VBA Reference (Page 1745) 

VarName Property (Page 2548) 
VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 
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Parent Property (Page 2359) 
Application Property (Page 2121) 


QualityCodeStateValues Object (Listing) 


Description 


A listing of QualityCodeStateValue objects which contain all quality codes in Dynamic dialog 


and are used for dynamization. 


VBA Object Name 
HMIQualityCodeStateValues 


2046 
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Application 


For example, use the Item property to define values in Dynamic dialog which will be used for 
dynamization when the specified tag returns the configured quality code. In the following 
example the radius of a circle is given dynamics with the dynamic dialog. Dynamization uses 
the analysis of the quality code of a tag. If the tag fails to return a quality code, a substitute 
value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA813 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 
"Activate qualitycode-statecheck 
-QualityCodeStateChecked = Tru 
End With 
With objDynDialog. QualityCodeStateValues (1) 
‘define a value for every state: 

. VALUE BAD COMMLUV = 20 

.VALUE_BAD_COMMNUV = 30 

. VALUE BAD CONFERROR = 40 


re! | 


. VALUE BAD DEVICE = 60 
.VALUE_BAD MISCSTATES = 70 
.VALUE_BAD NONSPECIFIC = 80 
.VALUE_BAD NOTCONNECTED = 90 
.VALUE_BAD_OUTOFSERV = 100 
.VALUE_BAD PROCRELNOM = 110 
. VALUE BAD PROCRELSUB = 120 
.VALUE_HIGHLIMITED = 130 
- VALUE LOWLIMITED = 140 
.VALUE_UNCERT ENGVHIGHLIM = 150 
.VALUE_UNCERT_ENGVLOWLIM = 160 
.VALUE_UNCERT INITVAL = 170 
.VALUE_UNCERT LUV = 180 
.VALUE_UNCERT MAINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
.VALUE_UNCERT NONSPECIFIC = 210 
VALUE_UNCERT_PROCRELNOM = 220 
VALUE_UNCERT SIMVAL = 230 
VALUE_UNCERT SUBSTSET = 240 
End With 
End Sub 
Object properties 

The object QualityCodeStateValues has the following properties: 

e Application 

e Count 
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See also 


2048 


e |tem 


e Parent 


VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VBA Reference (Page 1745) 

VarName Property (Page 2548) 
VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 

Parent Property (Page 2359) 

Item Property (Page 2283) 

Count Property (Page 2201) 

Application Property (Page 2121) 
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R-Z 
Rectangle Object 
Description 
Represents the "Rectangle" object. The Rectangle object is an element of the following listings: 
@ Objects: Contains all objects of a picture. 
® Selection: Contains all selected objects of a picture. 
e HMIDefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 
VBA Object Name 
HM Rectangle 
Usage 


Use the Add method to create a new "Rectangle" object in a picture: 


Sub AddRectangle () 


'VBA320 

Dim objRectangle As HMIRectangle 

Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 
End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditRectangle() 


'VBA321 

Dim objRectangle As HMIRectangle 

Set objRectangle = ActiveDocument.HMIObjects ("Rectanglel") 
objRectangle.BorderColor = RGB(255, 0, 0) 

End Sub 
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Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 


"VBA322 


"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 


"Get th 


End Sub 


See also 


2050 


nam 


of the first object of the selection: 


sgBox ActiveDocument.Selection(1) .ObjectName 


SelectedObjects object (Listing) (Page 2060) 
HM|Objects Object (Listing) (Page 1990) 


HMIDefaultObjects Object (Listing) (Page 1985) 


AddHMlObject Method (Page 1801) 
VBA Reference (Page 1745) 

Editing Objects with VBA (Page 1660) 
Width Property (Page 2553) 

Visible Property (Page 2551) 

Top Property (Page 2446) 

ToolTipText Property (Page 2445) 
PasswordLevel Property (Page 2362) 
Operation Property (Page 2353) 

Left Property (Page 2305) 

Layer Property (Page 2293) 

Height Property (Page 2269) 
FlashRateBorderColor Property (Page 2249) 
FlashRateBackColor Property (Page 2247) 
FlashBorderColor Property (Page 2240) 
FlashBackColor Property (Page 2239) 
FillStyle Property (Page 2235) 
Fillinglndex Property (Page 2233) 
Filling Property (Page 2232) 

FillColor Property (Page 2231) 
BorderWidth Property (Page 2161) 
BorderStyle Property (Page 2160) 
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BorderFlashColorOn Property (Page 2159) 
BorderFlashColorOff Property (Page 2157) 
BorderColor Property (Page 2153) 
BorderBackColor Property (Page 2152) 
BackFlashColorOn Property (Page 2139) 
BackFlashColorOff Property (Page 2138) 
BackColor Property (Page 2131) 
Application Property (Page 2121) 

Events Property (Page 2223) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 

Parent Property (Page 2359) 

Properties Property (Page 2388) 

Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 

Type Property (Page 2450) 
DrawlinsideFrame property (Page 2218) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 
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RoundButton Object 


Description 
Represents the "Round Button" object. The RoundButton object is an element of the following 
listings: 
@ Objects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 
e HM|DefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 
VBA Object Name 
HM |RoundButton 
Usage 


Use the Add method to create a new "Round Button" object in a picture: 


Sub AddRoundButton () 

"VBA323 

Dim objRoundButton As HMIRoundButton 

Set objRoundButton = ActiveDocument.HMIObjects.AddHMIObject ("Roundbuttonl", 
"HMITRoundButton") 

End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditRoundButton () 

"VBA324 

Dim objRoundButton As HMTRoundButton 

Set objRoundButton = ActiveDocument.HMIObjects ("Roundbuttonl1") 
objRoundButton.BorderColor = RGB(255, 0, 0) 

End Sub 
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Use "Selection"(Index) to return an object from the Selection listing.: 


Sub ShowNameOfFirstSelectedObject () 

"VBA325 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name from the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
ToolTipText Property (Page 2445) 
FlashBackColor Property (Page 2239) 
SelectedObjects object (Listing) (Page 2060) 
HMlObjects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
AddHMlObject Method (Page 1801) 
VBA Reference (Page 1745) 
Editing Objects with VBA (Page 1660) 
Width Property (Page 2553) 
Visible Property (Page 2551) 
Top Property (Page 2446) 
Toggle Property (Page 2441) 
Radius Property (Page 2394) 
Pressed Property (Page 2382) 
PicUpUseTransColor Property (Page 2377) 
PicUpTransparent Property (Page 2376) 
PicUpReferenced Property (Page 2375) 
PictureUp Property (Page 2374) 
PictureDown Property (Page 2372) 
PictureDeactivated Property (Page 2371) 
PicDownUseTransColor Property (Page 2369) 
PicDownTransparent Property (Page 2368) 
PicDownReferenced Property (Page 2367) 
PicDeactUseTransColor Property (Page 2367) 
PicDeactTransparent Property (Page 2366) 
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PicDeactReferenced-Eigenschaft (Page 2365) 


PasswordLevel Property (Page 2362) 
Operation Property (Page 2353) 

Left Property (Page 2305) 

Layer Property (Page 2293) 

Height Property (Page 2269) 


FlashRateBorderColor Property (Page 2249) 


FlashRateBackColor Property (Page 2247) 
FlashBorderColor Property (Page 2240) 
FillStyle Property (Page 2235) 

Fillinglndex Property (Page 2233) 

Filling Property (Page 2232) 

FillColor Property (Page 2231) 
BorderWidth Property (Page 2161) 
BorderStyle Property (Page 2160) 
BorderFlashColorOn Property (Page 2159) 
BorderFlashColorOff Property (Page 2157) 
BorderColorTop Property (Page 2155) 
BorderColor Property (Page 2153) 
BorderColorBottom Property (Page 2155) 
BorderBackColor Property (Page 2152) 
BackFlashColorOn Property (Page 2139) 
BackFlashColorOff Property (Page 2138) 
BackColor Property (Page 2131) 
BackBorderWidth Property (Page 2131) 
AlignmentLeft Property (Page 2117) 
AlignmentTop Property (Page 2118) 
Application Property (Page 2121) 
DisplayOptions Property (Page 2215) 
Events Property (Page 2223) 

FontBold Property (Page 2256) 

Fontltalic Property (Page 2257) 

FontName Property (Page 2257) 

FontSize Property (Page 2258) 
FontUnderline Property (Page 2259) 
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ForeColor Property (Page 2260) 


GlobalColorScheme property (Page 2264) 


GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
LDFonts Property (Page 2298) 

LDTexts Property (Page 2303) 
LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 
Parent Property (Page 2359) 
PictAlignment property (Page 2370) 
Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Text Property (Page 2439) 
Transparency property (Page 2447) 
Type Property (Page 2450) 
WinCCStyle property (Page 2554) 
WindowsStyle property (Page 2557) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


RoundRectangle Object 


Description 
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Represents the "Rounded Rectangle" object. The RoundRectangle object is an element of the 


following listings: 
@ Objects: Contains all objects of a picture. 


@ Selection: Contains all selected objects of a picture. 


e HM|DefaultObjects: Contains the default property values of all standard, Windows, and 


smart objects. 


VBA Object Name 
HMIRoundRectangle 


Usage 


Use the Add method to create a new "Rounded Rectangle" object in a picture: 


Sub AddRoundRectangle() 
"VBA326 


Dim objRoundRectangle As HMIRoundRectangle 

Set objRoundRectangle = ActiveDocument.HMIObjects.AddHMIObject ("Roundrectanglel", 
"HMTRoundRectangle") 

End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 


case identifies the object by name: 


Sub EditRoundRectangle () 


'VBA327 

Dim objRoundRectangle As HMIRoundRectangle 

Set objRoundRectangle = ActiveDocument.HMIObjects ("Roundrectanglel") 
objRoundRectangle.BorderColor = RGB(255, 0, 0) 

End Sub 


Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

"VBA328 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name of the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
Width Property (Page 2553) 
BorderBackColor Property (Page 2152) 
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SelectedObjects object (Listing) (Page 2060) 
HMlObjects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
AddHMlObject Method (Page 1801) 

VBA Reference (Page 1745) 

Editing Objects with VBA (Page 1660) 
Visible Property (Page 2551) 

Top Property (Page 2446) 

ToolTipText Property (Page 2445) 
RoundCornerWidth Property (Page 2402) 
RoundCornerHeight Property (Page 2401) 
PasswordLevel Property (Page 2362) 
Operation Property (Page 2353) 

Left Property (Page 2305) 

Layer Property (Page 2293) 

Height Property (Page 2269) 
FlashRateBorderColor Property (Page 2249) 
FlashRateBackColor Property (Page 2247) 
FlashBorderColor Property (Page 2240) 
FlashBackColor Property (Page 2239) 
FillStyle Property (Page 2235) 

Fillinglndex Property (Page 2233) 

Filling Property (Page 2232) 

FillColor Property (Page 2231) 
BorderWidth Property (Page 2161) 
BorderStyle Property (Page 2160) 
BorderFlashColorOn Property (Page 2159) 
BorderFlashColorOff Property (Page 2157) 
BorderColor Property (Page 2153) 
BackFlashColorOn Property (Page 2139) 
BackFlashColorOff Property (Page 2138) 
BackColor Property (Page 2131) 
Application Property (Page 2121) 

Events Property (Page 2223) 
GlobalColorScheme property (Page 2264) 
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Scriptinfo Object 


Description 


GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 
Parent Property (Page 2359) 

Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 
Type Property (Page 2450) 
DrawlinsideFrame property (Page 2218) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


Represents a script (C, VB) that is configured for adding dynamics to a property or action to 


an event. 


VBA Object Name 
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HM|Scriptinfo 
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Usage 


Use the CreateDynamic method to make a property dynamic with the aid of a script. In the 
following example... 


Sub AddDynamicAsCSkriptToProperty () 

"VBA329 

Dim objCScript As HMIScriptInfo 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circlel", “HMICircle") 
Set objCScript = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeCScript) 


"Define triggertype and cycletime: 
With objCScript 


-SourceCode = ™" 

-Trigger.Type = hmiTriggerTypeStandardCycle 
.Trigger.CycleType = hmiCycleType 2s 
.Trigger.Name = "Trigger1" 

End With 

End Sub 


Use the AddAction method to configure an action on an event. In the following example... 


Sub AddActionToPropertyTypeCScript () 

'VBA330 

Dim objEvent As HMIEvent 

Dim objCScript As HMIScriptInfo 

Dim objCircle As HMICircle 

‘Add circle to picture. By changing of property "Radius" 


"a C-action is added: 
Set objCircle = ActiveDocument .HMIObjects.AddHMIObject ("Circle AB", "HMICircle") 
Set objEvent = objCircle.Radius.Events (1) 


Set objCScript = objEvent.Actions.AddAction (hmiActionCreationTypeCScript) 
End Sub 


See also 
Prototype Property (Page 2389) 
Delete Method (Page 1831) 
VBA Reference (Page 1745) 
Creating Dynamics with VBA (Page 1686) 
Trigger Property (Page 2449) 
SourceCode Property (Page 2424) 
ScriptType Property (Page 2407) 
Parent Property (Page 2359) 
Compiled Property (Page 2197) 
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Application Property (Page 2121) 
UsedLanguage property (Page 2464) 


SelectedObjects object (Listing) 


Description 

A listing of the HMlObject objects that represent all the selected objects in a picture. 
VBA Object Name 

HMISelectedObjects 
Usage 


Use the Selection property to return the Selection listing. In the following example the names 
of all the selected objects in the active picture will be output: 


Sub ShowSelectionOfDocument () 


"'VBA331 


Dim colSelection As HMISelectedObjects 
Dim objObject As HMIObject 
Dim strObjectList As String 


Set colSel 


ction = ActiveDocument.Selection 


If colSelection.Count <> 0 Then 

strObjectList = "List of selected objects:" 

For Each objObject In colSelection 

strObjectList = strObjectList & vbCrLf & objObject.ObjectNam 


Else 


End If 


End Sub 
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Next objObject 


strObjectList = "No objects selected" 


MsgBox strObjectList 
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Use the SelectAll method, for example, to select all the objects in the picture. In the following 
example all the objects in the active picture are selected: 


Sub SelectAllObjects () 


"VBA332 


ActiveDocument.Selection.SelectAll 


End Sub 


See also 


HM|lObjects Object (Listing) (Page 1990) 
AlignTop Method (Page 1810) 
HMIDefaultObjects Object (Listing) (Page 1985) 
BringToFront Method (Page 1813) 
SendToBack Method (Page 1883) 

SelectAll Method (Page 1882) 
SameWidthAndHeight Method (Page 1877) 
SameWidth Method (Page 1876) 

SameHeight Method (Page 1874) 

Rotate Method (Page 1872) 

Remove Method (Page 1871) 
ForwardOneLevel Method (Page 1846) 
BackwardOneLevel Method (Page 1811) 
MoveSelection Method (Page 1865) 

Item Method (Page 1859) 

FlipVertically Method (Page 1845) 
FlipHorizontally Method (Page 1843) 
EvenlySpaceVertically Method (Page 1838) 
EvenlySpaceHorizontally Method (Page 1837) 
DuplicateSelection Method (Page 1836) 
DeselectAll Method (Page 1834) 

DeleteAll Method (Page 1832) 

CreateGroup Method (Page 1829) 
CreateCustomizedObject Method (Page 1825) 
CopySelection Method (Page 1823) 
CenterVertically Method (Page 1816) 
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Slider object 


CenterHorizontally Method (Page 1815) 

AlignRight Method (Page 1809) 

AlignLeft Method (Page 1808) 

AlignBottom Method (Page 1807) 

How to Edit a Customized Object with VBA (Page 1683) 

How to Edit the Group Objects Using VBA (Page 1676) 

How to edit Default objects, Smart objects, Windows objects and Tube objects (Page 1664) 
VBA Reference (Page 1745) 

Customized Objects (Page 1682) 

Group Objects (Page 1674) 

Default objects, Smart objects, Windows objects and Tube objects (Page 1662) 
Editing Objects with VBA (Page 1660) 

Parent Property (Page 2359) 

Count Property (Page 2201) 

Application Property (Page 2121) 


Description 

Represents the object called "Slider Object". The Slider object is an element of the following 

listings: 

@ Objects: Contains all objects of a picture. 

@ Selection: Contains all selected objects of a picture. 

e HMlIDefaultObjects: Contains the default property values of all standard, Windows, and 

smart objects. 

VBA Object Name 

HMIsSlider 
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Usage 


Use the Add method to create a new "Slider Object" object in a picture: 


Sub AddSlider () 

'VBA333 

Dim objSlider As HMISlider 

Set objSlider = ActiveDocument.HMIObjects.AddHMIObject ("Slider1l", "HMISlider") 
End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditSlider () 

'VBA334 

Dim objSlider As HMISlider 

Set objSlider = ActiveDocument.HMIObjects ("Sliderl1") 
objSlider.ButtonColor = RGB(255, 0, 0) 

End Sub 


Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

'VBA335 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name of the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
OperationReport Property (Page 2355) 
BorderFlashColorOff Property (Page 2157) 
SelectedObjects object (Listing) (Page 2060) 
HMlObjects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
AddHM Object Method (Page 1801) 
VBA Reference (Page 1745) 
Editing Objects with VBA (Page 1660) 
Width Property (Page 2553) 
Visible Property (Page 2551) 
Top Property (Page 2446) 
ToolTipText Property (Page 2445) 
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SmallChange Property (Page 2421) 
Process Property (Page 2383) 
PasswordLevel Property (Page 2362) 
OperationMessage Property (Page 2354) 
Operation Property (Page 2353) 

Min Property (Page 2340) 

Max Property (Page 2322) 

Left Property (Page 2305) 

Layer Property (Page 2293) 

Height Property (Page 2269) 
FlashRateBorderColor Property (Page 2249) 
FlashRateBackColor Property (Page 2247) 
FlashBorderColor Property (Page 2240) 
FlashBackColor Property (Page 2239) 
FillStyle Property (Page 2235) 
Fillinglndex Property (Page 2233) 

Filling Property (Page 2232) 

FillColor Property (Page 2231) 
ExtendedOperation Property (Page 2227) 
Direction Property (Page 2213) 

ColorTop Property (Page 2191) 
ColorBottom Property (Page 2184) 
ButtonColor Property (Page 2167) 
BorderWidth Property (Page 2161) 
BorderStyle Property (Page 2160) 
BorderFlashColorOn Property (Page 2159) 
BorderColor Property (Page 2153) 
BorderBackColor Property (Page 2152) 
BackFlashColorOn Property (Page 2139) 
BackFlashColorOff Property (Page 2138) 
BackColorTop Property (Page 2135) 
BackColor Property (Page 2131) 
BackColorBottom Property (Page 2135) 
BackBorderWidth Property (Page 2131) 
Application Property (Page 2121) 
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Events Property (Page 2223) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 
Parent Property (Page 2359) 

Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 
Type Property (Page 2450) 
WinCCStyle property (Page 2554) 
WindowsStyle property (Page 2557) 
DrawlnsideFrame property (Page 2218) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


SourceLink Object 


Description 


Represents the source for a direct connection. 


VBA Object Name 
HMlISourceLink 
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Usage 


Use the SourceLink property to return the SourceLink object. In the following example the X 
position of "Rectangle_A" is copied to the Y position of "Rectangle_B" in Runtime by clicking 
on the button: 


Sub DirectConnection () 

'VBA336 

Dim objButton As HMIButton 

Dim objRectangleA As HMIRectangle 

Dim objRectangleB As HMIRectangle 

Dim objEvent As HMIEvent 

Dim objDirConnection As HMIDirectConnection 


"Add objects to active document: 

Set objRectangleA = ActiveDocument.HMIObjects.AddHMIObject ("Rectangle A", "HMIRectangle") 
Set objRectangleB = ActiveDocument.HMIObjects.AddHMIObject ("Rectangle B", "HMIRectangle") 
Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMTButton") 

With objRectangleA 

-Top = 100 

-Left = 100 


With objRectangleB 

op = 250 

-Left = 400 

-BackColor = RGB(255, 0, O) 
End With 
With objButton 
-Top = 10 
-Left = 10 


-Text = "SetPosition" 
End With 
d 


"Initiation of directconnection by mouseclick: 
Set objDirConnection = 
objButton.Events (1) .Actions.AddAction (hmiActionCreationTypeDirectConnection) 
With objDirConnection 

"Sourceobject: Top-property of Rectangle A 


-SourceLink.Type = hmiSourceTypeProperty 
-SourceLink.ObjectName = "Rectangle A" 
-SourceLink.AutomationName = "Top" 

' 

"Targetobject: Left-property of Rectangle B 
.DestinationLink.Type = hmiDestTypeProperty 
.DestinationLink.ObjectName = "Rectangle B" 
.DestinationLink.AutomationName = "Left" 
End With 

End Sub 
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See also 
DirectConnection Object (Page 1947) 
VBA Reference (Page 1745) 
Type Property (Page 2450) 
SourceLink Property (Page 2422) 
ObjectName Property (Page 2347) 
AutomationName Property (Page 2124) 
Application Property (Page 2121) 
Parent Property (Page 2359) 


StaticText Object 


Description 


Represents the "Static Text" object. The StaticText object is an element of the following listings: 
@ Objects: Contains all objects of a picture. 
® Selection: Contains all selected objects of a picture. 


e HM|DefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 


VBA Object Name 
HMIStaticText 
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Usage 


Use the Add method to create a new "Static Text" object in a picture: 


Sub AddStaticText () 
"VBA337 
Dim objStaticText As HMIStaticText 

Set objStaticText = ActiveDocument.HMIObjects.AddHMIObject ("Static Textl", "HMIStaticText") 
End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditStaticText () 

'VBA338 

Dim objStaticText As HMIStaticText 

Set objStaticText = ActiveDocument.HMIObjects ("Static Textl") 
objStaticText.BorderColor = RGB(255, 0, 0) 

End Sub 


Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

"VBA339 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name of the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
SelectedObjects object (Listing) (Page 2060) 
FontBold Property (Page 2256) 
HM|lObjects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
AddHMlObject Method (Page 1801) 
VBA Reference (Page 1745) 
Editing Objects with VBA (Page 1660) 
Width Property (Page 2553) 
Visible Property (Page 2551) 
Top Property (Page 2446) 
ToolTipText Property (Page 2445) 
Text Property (Page 2439) 
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PasswordLevel Property (Page 2362) 
Orientation Property (Page 2356) 
Operation Property (Page 2353) 

Left Property (Page 2305) 

Layer Property (Page 2293) 

Height Property (Page 2269) 
ForeFlashColorOn Property (Page 2262) 
ForeFlashColorOff Property (Page 2261) 
ForeColor Property (Page 2260) 
FontUnderline Property (Page 2259) 
FontSize Property (Page 2258) 

FontName Property (Page 2257) 

Fontltalic Property (Page 2257) 
FlashRateForeColor Property (Page 2251) 
FlashRateBorderColor Property (Page 2249) 
FlashRateBackColor Property (Page 2247) 
FlashForeColor Property (Page 2242) 
FlashBorderColor Property (Page 2240) 
FlashBackColor Property (Page 2239) 
FillStyle Property (Page 2235) 

Fillinglndex Property (Page 2233) 

Filling Property (Page 2232) 

FillColor Property (Page 2231) 
BorderWidth Property (Page 2161) 
BorderStyle Property (Page 2160) 
BorderFlashColorOn Property (Page 2159) 
BorderFlashColorOff Property (Page 2157) 
BorderColor Property (Page 2153) 
BorderBackColor Property (Page 2152) 
BackFlashColorOn Property (Page 2139) 
BackFlashColorOff Property (Page 2138) 
BackColor Property (Page 2131) 
AlignmentTop Property (Page 2118) 
AlignmentLeft Property (Page 2117) 
AdaptBorder Property (Page 2111) 
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Application Property (Page 2121) 

Events Property (Page 2223) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
LDFonts Property (Page 2298) 

LDTexts Property (Page 2303) 
LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 

Parent Property (Page 2359) 

Properties Property (Page 2388) 
ReferenceRotationLeft Property (Page 2396) 
ReferenceRotationTop Property (Page 2397) 
RotationAngle Property (Page 2400) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 

Type Property (Page 2450) 
DrawlnsideFrame property (Page 2218) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


StatusDisplay Object 


Description 
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Represents the "Status Display" object. The "StatusDisplay" object is an element of the 
following listings: 


@ Objects: Contains all objects of a picture. 
® Selection: Contains all selected objects of a picture. 


e HM DefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 


VBA Object Name 
HM|StatusDisplay 


Usage 


Use the Add method to create a new "Status Display" object in a picture: 


Sub AddStatusDisplay () 

"VBA340 

Dim objStatusDisplay As HMIStatusDisplay 

Set objStatusDisplay = ActiveDocument.HMIObjects.AddHMIObject ("Statusdisplayl", 
"HMIStatusDisplay") 

End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditStatusDisplay() 

"VBA341 

Dim objStatusDisplay As HMIStatusDisplay 

Set objStatusDisplay = ActiveDocument.HMIObjects ("Statusdisplayl") 
objStatusDisplay.BorderColor = RGB(255, 0, 0) 

End Sub 


Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

"VBA342 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name of the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
ToolTipText Property (Page 2445) 
BasePicReferenced Property (Page 2143) 
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SelectedObjects object (Listing) (Page 2060) 
HM|Objects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
AddHMlObject Method (Page 1801) 

VBA Reference (Page 1745) 

Editing Objects with VBA (Page 1660) 

Width Property (Page 2553) 

Visible Property (Page 2551) 

Top Property (Page 2446) 

PasswordLevel Property (Page 2362) 
Operation Property (Page 2353) 

Left Property (Page 2305) 

Layer Property (Page 2293) 

Index Property (Page 2276) 

Height Property (Page 2269) 
FlashRateFlashPic Property (Page 2250) 
FlashRateBorderColor Property (Page 2249) 
FlashPicUseTransColor Property (Page 2246) 
FlashPicture Property (Page 2244) 
FlashPicTransColor Property (Page 2243) 
FlashPicReferenced Property (Page 2242) 
FlashFlashPicture Property (Page 2241) 
FlashBorderColor Property (Page 2240) 
BorderWidth Property (Page 2161) 
BorderStyle Property (Page 2160) 
BorderFlashColorOn Property (Page 2159) 
BorderFlashColorOff Property (Page 2157) 
BorderColor Property (Page 2153) 
BorderBackColor Property (Page 2152) 
BasePicUseTransColor Property (Page 2145) 
BasePicture Property (Page 2144) 
BasePicTransColor Property (Page 2144) 
Application Property (Page 2121) 

Events Property (Page 2223) 
GlobalColorScheme property (Page 2264) 
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GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 
Parent Property (Page 2359) 

Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 
Type Property (Page 2450) 
DrawlinsideFrame property (Page 2218) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


SymbolLibraries Object (Listing) 


Description 
A listing of the SymbolLibrary objects that represent the Components Library. The listing 
contains two objects: The first object is the "Global Library" and the second object is the "Project 
Library”. 

VBA Object Name 


HM ISymbolLibraries 
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Usage 


Use the SymbolLibraries property to return the SymbolLibraries listing. In the following example 
the names of the libraries will be output: 


Sub ShowSymbolLibraries() 
'VBA344 
Dim colSymbolLibraries As HMISymbolLibraries 

Dim objSymbolLibrary As HMISymbolLibrary 

Dim strLibraryList As String 

Set colSymbolLibraries = Application.SymbolLibraries 

For Each objSymbolLibrary In colSymbolLibraries 

strLibraryList = strLibraryList & objSymbolLibrary.Name & vbCrLf 
Next objSymbolLibrary 

MsgBox strLibraryList 


End Sub 

See also 
SymbolLibrary Object (Page 2074) 
Item Method (Page 1859) 
VBA Reference (Page 1745) 
Accessing the component library with VBA (Page 1646) 
Parent Property (Page 2359) 
Count Property (Page 2201) 
Application Property (Page 2121) 

SymbolLibrary Object 

Description 


Represents the "Global Library" or "Project Library". The SymbolLibrary object is an element 
of the SymbolLibraries listing. 
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VBA Object Name 
HM ISymbolLibrary 


Usage 


Use SymbolLibraries(Index) to return an individual SymbolLibrary object. "For Index you can 
use either the index number or the name of the object. In the following example the name of 
the "Global Library" will be output: 


Sub ShowFirstObjectOfCollection() 

"VBA343 

Dim strName As String 

strName = Application.SymbolLibraries (1) .Name 
sgBox strName 

End Sub 


See also 
SymbolLibraries Object (Listing) (Page 2073) 
GetltemByPath Method (Page 1847) 
FindByDisplayName Method (Page 1842) 
VBA Reference (Page 1745) 
Accessing the component library with VBA (Page 1646) 
Parent Property (Page 2359) 
Name Property (Page 2343) 
Folderltems Property (Page 2254) 
Application Property (Page 2121) 
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TextList Object 
Description 
Represents the "Text List" object. The TextList object is an element of the following listings: 
@ Objects: Contains all objects of a picture. 
e@ Selection: Contains all selected objects of a picture. 
e HM DefaultObjects: Contains the default property values of all standard, Windows, and 
smart objects. 
VBA Object Name 
HMITextList 
Usage 


Sub AddText 


"VBA345 
Dim objText 
Set objText 
End Sub 


Sub EditTex 
"VBA346 
Dim objText 
Set objText 
objTextList 
End Sub 
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Use the Add method to create a new "Text List" object in a picture: 


List () 


List As HMITextList 
List = ActiveDocument.HMIObjects.AddHMIObject ("Textlist1", "HMITextList") 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


tList () 


List As HMITextList 
List = ActiveDocument.HMIObjects ("Textlist1") 


-BorderColor = RGB(255, 0, O) 
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Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

"VBA347 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name of the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
Width Property (Page 2553) 
ForeFlashColorOn Property (Page 2262) 
BitNumber Property (Page 2148) 
SelectedObjects object (Listing) (Page 2060) 
HMlObjects Object (Listing) (Page 1990) 
HMIDefaultObjects Object (Listing) (Page 1985) 
AddHMlObject Method (Page 1801) 
VBA Reference (Page 1745) 
Editing Objects with VBA (Page 1660) 
Visible Property (Page 2551) 
UnselTextColor Property (Page 2462) 
UnselBGColor Property (Page 2462) 
Top Property (Page 2446) 
ToolTipText Property (Page 2445) 
SelTextColor Property (Page 2414) 
SelBGColor Property (Page 2412) 
PasswordLevel Property (Page 2362) 
OutputValue Property (Page 2358) 
Orientation Property (Page 2356) 
OperationReport Property (Page 2355) 
OperationMessage Property (Page 2354) 
Operation Property (Page 2353) 
NumberLines Property (Page 2346) 
ListType Property (Page 2312) 
Left Property (Page 2305) 
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Layer Property (Page 2293) 
LanguageSwitch Property (Page 2291) 
ItemBorderWidth Property (Page 2286) 
ItemBorderStyle Property (Page 2285) 
ItemBorderColor Property (Page 2284) 
ItemBorderBackColor Property (Page 2283) 
Height Property (Page 2269) 
ForeFlashColorOff Property (Page 2261) 
ForeColor Property (Page 2260) 
FontUnderline Property (Page 2259) 
FontSize Property (Page 2258) 

FontName Property (Page 2257) 

Fontltalic Property (Page 2257) 

FontBold Property (Page 2256) 
FlashRateForeColor Property (Page 2251) 
FlashRateBorderColor Property (Page 2249) 
FlashRateBackColor Property (Page 2247) 
FlashForeColor Property (Page 2242) 
FlashBorderColor Property (Page 2240) 
FlashBackColor Property (Page 2239) 
FillStyle Property (Page 2235) 

FillColor Property (Page 2231) 

EditAtOnce Property (Page 2219) 
CursorControl Property (Page 2206) 
BoxType Property (Page 2165) 
BorderWidth Property (Page 2161) 
BorderStyle Property (Page 2160) 
BorderFlashColorOn Property (Page 2159) 
BorderFlashColorOff Property (Page 2157) 
BorderColor Property (Page 2153) 
BorderBackColor Property (Page 2152) 
BackFlashColorOn Property (Page 2139) 
BackFlashColorOff Property (Page 2138) 
BackColor Property (Page 2131) 
AssumeOnExit Property (Page 2123) 
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Assignments Property (Page 2122) 
AlignmentTop Property (Page 2118) 
AlignmentLeft Property (Page 2117) 
AdaptBorder Property (Page 2111) 
Application Property (Page 2121) 
Events Property (Page 2223) 
GlobalColorScheme property (Page 2264) 
GlobalShadow property (Page 2264) 
GroupParent Property (Page 2268) 
InputValue property (Page 2279) 
LDTooltipTexts Property (Page 2303) 
ObjectName Property (Page 2347) 
Parent Property (Page 2359) 

Properties Property (Page 2388) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Transparency property (Page 2447) 
Type Property (Page 2450) 
ConnectionPoints property (Page 2198) 
DropDownListStyle property (Page 2218) 
LDAssignments property (Page 2298) 
TextBiblIDs property (Page 2439) 
ConnectorObjects property (Page 2199) 
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Toolbar Object 

Description 
Represents the "User Defined Toolbar" object. The Toolbar object is an element of the 
CustomToolbars listing. 

VBA Object Name 
HM!Toolbar 

Usage 


Use CustomToolbars(Index) to return an individual Toolbar object. "For Index you can use 
either the index number or the name of the object. In the following example the "Key" parameter 
of the first user-defined toolbar in the active picture will be output: 


Sub ShowFirstObjectOfCollection() 


'VBA348 

Dim strName As String 

strName = ActiveDocument.CustomToolbars (1) .Key 
MsgBox strName 

End Sub 


Use the Delete method to remove a "Toolbar" object from the "CustomToolbars" listing. In the 
following example the first user-defined toolbar in the active picture will be removed: 


Sub DeleteToolbar () 

"VBA349 

Dim objToolbar As HMIToolbar 

Set objToolbar = ActiveDocument.CustomToolbars (1) 
objToolbar.Delete 

End Sub 
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See also 
Key Property (Page 2287) 
Toolbars Object (Listing) (Page 2081) 
Delete Method (Page 1831) 
How to Create Picture-specific Menus and Toolbars (Page 1655) 
How to Create an Application-specific Toolbar (Page 1635) 
VBA Reference (Page 1745) 
Creating Customized Menus and Toolbars (Page 1627) 
Visible Property (Page 2551) 
Toolbarltems Property (Page 2443) 
Parent Property (Page 2359) 
Application Property (Page 2121) 


Toolbars Object (Listing) 


Description 


A listing of the Toolbar objects that represent all the user-defined toolbars in the Graphics 
Designer. 


VBA Object Name 
HMICustomToolbars 


Usage 


Note 


In order for the examples to work, first create a user-defined toolbar. For an example of this, 
please refer to "Creating a New Application-Specific Toolbar" in this documentation. 
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Use the CustomToolbars property to return the Toolbars listing. In the following example, 
values for the "Key" property of all user-defined toolbars in the active picture will be output: 


Note 


The Toolbars listing does not distinguish between application-specific and picture-specific 
toolbars in the output. 


Sub ShowCustomToolbarsOfDocument () 

"VBA350 

Dim colToolbars As HMIToolbars 

Dim objToolbar As HMIToolbar 

Dim strToolbarList As String 

Set colToolbars = ActiveDocument.CustomToolbars 

If 0 <> colToolbars.Count Then 

For Each objToolbar In colToolbars 

strToolbarList = strToolbarList & objToolbar.Key & vbCrLf 
ext objToolbar 

Else 


strToolbarList = "No toolbars existing" 
End If 
sgBox strToolbarList 
End Sub 


Use the Application property and the Add method if you want to create an application-specific 
toolbar. Create the VBA code in either the "Project Template" document or the "Global 
Template" document. 


Sub InsertApplicationSpecificToolbar () 

"VBA351 

Dim objToolbar As HMIToolbar 

Set objToolbar = Application.CustomToolbars.Add("a_Toolbari") 
End Sub 


Use the ActiveDocument property and the Add method if you want to create a picture-specific 
toolbar. Create the VBA code in the document called "ThisDocument": 


Sub InsertDocumentSpecificToolbar() 

"VBA352 

Dim objToolbar As HMIToolbar 

Set objToolbar = ActiveDocument.CustomToolbars.Add("d_Toolbari") 
End Sub 


See also 
Toolbar Object (Page 2080) 
Item Method (Page 1859) 
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Add Method (Page 1786) 

How to Create Picture-specific Menus and Toolbars (Page 1655) 
How to Create an Application-specific Toolbar (Page 1635) 

VBA Reference (Page 1745) 

Creating Customized Menus and Toolbars (Page 1627) 

Parent Property (Page 2359) 

Count Property (Page 2201) 

Application Property (Page 2121) 


Toolbarltem Object 


Description 
Represents an object (icon or dividing line) in a user-defined toolbar in the GraphicsDesigner. 
The Toolbarltem object is an element of the Toolbarltems listing. 

VBA Object Name 
HMIToolbarltem 

Usage 


Note 


In order for the examples to work, first create a user-defined toolbar. For an example of this, 
please refer to "Creating a New Application-Specific Toolbar" in this documentation. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 2083 


VBA for Automated Configuration 
3.6 VBA Reference 


Use Toolbarltems(Index) to return an individual Toolbarltem object. "For Index you can use 
either the index number or the name of the object. In the following example the type of the first 
object in the first user-defined toolbar in the active picture will be output: 


Sub ShowFirstObjectOfCollection() 


"VBA353 

Dim strType As String 

strType = ActiveDocument.CustomToolbars (1) .ToolbarItems(1).ToolbarItemType 
sgBox strType 

End Sub 


Use the Delete method to remove an object from the "Toolbarltems" listing. In the following 
example the first object will be deleted from the first user-defined toolbar in the active picture: 


Sub DeleteToolbarItem() 

"VBA354 
ActiveDocument.CustomToolbars(1).ToolbarItems(1).Delete 
End Sub 


See also 
Macro Property (Page 2320) 
Toolbarltems Object (Listing) (Page 2085) 
Delete Method (Page 1831) 
Configuring Menus and Toolbars (Page 1626) 
How to assign VBA macros to menus and toolbars (Page 1642) 
How to assign help texts to menus and toolbars (Page 1639) 
How to Add a New Icon to the Toolbar (Page 1637) 
VBA Reference (Page 1745) 
Creating Customized Menus and Toolbars (Page 1627) 
Visible Property (Page 2551) 
Type Property (Page 2450) 
ToolTipText Property (Page 2445) 
Tag Property (Page 2434) 
StatusText Property (Page 2426) 
ShortCut Property (Page 2416) 
Position Property (Page 2380) 
Parent Property (Page 2359) 
LDTooltipTexts Property (Page 2303) 
LDStatusTexts Property (Page 2301) 
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Key Property (Page 2287) 

Icon Property (Page 2275) 

Enabled Property (Page 2220) 
Application Property (Page 2121) 
ToolbarltemType property (Page 2444) 


Toolbarltems Object (Listing) 


Description 

A listing of the Toolbarltem objects that represent all the objects in a user-defined toolbar. 
VBA Object Name 

HM!Toolbarltems 
Usage 


Use the Toolbarltems property to return the Toolbarltems listing. In the following example, all 
object types in the first user-defined toolbar in the active picture will be output: 


Note 


The Toolbarltems listing does not distinguish between application-specific and picture-specific 
toolbars in the output. 
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Sub ShowToolbarItems () 

"VBA355 

Dim colToolbarItems As HMIToolbarItems 
Dim objToolbarItem As HMIToolbarItem 
Dim strTypeList As String 

Set colToolbarItems = ActiveDocument.CustomToolbars(1).ToolbarItems 
If 0 <> colToolbarItems.Count Then 

For Each objToolbarItem In colToolbarItems 


strTypeList = strTypeList & objToolbarItem.ToolbarItemType & vbCrhf 


ext objToolbarItem 
Else 

strTypeList = "No Toolbaritems existing" 
End If 

sgBox strTypeList 
End Sub 


Use the InsertToolbarltem method, for instance, to insert an icon into an existing user-defined 
toolbar. In the following example a picture-specific toolbar will be created in the active picture 
and an icon will be added: 


Sub InsertToolbarItem() 

"VBA356 

Dim objToolbar As HMIToolbar 

Dim objToolbarItem As HMIToolbarItem 

Set objToolbar = ActiveDocument.CustomToolbars.Add("d_Toolbar2") 

Set objToolbariItem = objToolbar.ToolbarItems.InsertToolbarItem(1, "t_Item2_1", 
"ToolbarItem 1") 

End Sub 


See also 
Toolbarltem Object (Page 2083) 
InsertToolbarltem Method (Page 1856) 
InsertSeparator Method (Page 1853) 
InsertFromMenultem Method (Page 1848) 
How to Add a New Icon to the Toolbar (Page 1637) 
VBA Reference (Page 1745) 
Creating Customized Menus and Toolbars (Page 1627) 
Parent Property (Page 2359) 
Count Property (Page 2201) 
Application Property (Page 2121) 
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Trigger Object 
Description 
Represents the trigger (e.g. Picture Cycle) that is necessary for adding dynamics to properties 
with the aid of scripts. A trigger can possess multiple tag triggers. 
VBA Object Name 
HMITrigger 
Usage 


Use the Trigger property to return the Trigger object. In this example the "Radius" property of 
a circle will be made dynamic with the aid of a VB script (the output value sets the radius): 


Sub AddDynamicAsVBSkriptToProperty () 
'VBA357 


Dim objVBScript As HMIScriptInfo 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circlel", "“HMICircle") 
Set objVBScript = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeVBScript) 


"Define cycletime and sourcecode 
With objVBScript 

-SourceCode = "™" 

-Trigger.Type = hmiTriggerTypeStandardCycle 
.Trigger.CycleType = hmiCycleType 2s 
.Trigger.Name = "Triggerl" 
End With 


End Sub 


See also 
Delete Method (Page 1831) 
VBA Reference (Page 1745) 
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VariableTriggers Property (Page 2548) 
Type Property (Page 2450) 

Trigger Property (Page 2449) 

Parent Property (Page 2359) 

Name Property (Page 2343) 
CycleType Property (Page 2209) 
Application Property (Page 2121) 


TubeArcObject object 


Description 


HM|IDefaultObjects 
HMlIObjects 


Represents the "Tube arc" object. The TubeArcObject object is an element of the following 
lists: 


TubeArcObject 


e HMlObjects: Contains all objects of a picture. 
® Selection: Contains all selected objects of a picture. 


e HMl|DefaultObjects: Contains the default property values of all default, smart, window and 
tube objects. 


VBA object name 
HM ITubeArcObject 
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Usage 


Use the Add method to create a new "Tube arc" object in a picture: 


Sub AddTubeArcObject () 
"VBA835 
Dim objTubeArcObject As HMITubeArcObject 

Set objTubeArcObject = ActiveDocument.HMIObjects.AddHMIObject ("TubeArcObject", 
"HMI TubeArcObject") 

End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditTubeArcObject () 

"VBA836 

Dim objTubeArcObject As HMITubeArcObject 

Set objTubeArcObject = ActiveDocument.HMIObjects ("TubeArcObject") 
objTubeArcObject.BorderColor = RGB(255, 0, 0) 

End Sub 


Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

"VBA837 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name from the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
ObjectName Property (Page 2347) 
Left Property (Page 2305) 
Layer Property (Page 2293) 
Top Property (Page 2446) 
Width Property (Page 2553) 
Height Property (Page 2269) 
BorderColor Property (Page 2153) 
BorderWidth Property (Page 2161) 
ToolTipText Property (Page 2445) 
Visible Property (Page 2551) 
PasswordLevel Property (Page 2362) 
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Operation Property (Page 2353) 
Transparency property (Page 2447) 
GlobalShadow property (Page 2264) 
GlobalColorScheme property (Page 2264) 
StartAngle Property (Page 2426) 
EndAngle Property (Page 2222) 
RadiusHeight Property (Page 2394) 
RadiusWidth Property (Page 2395) 
Application Property (Page 2121) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


TubeDoubleTeeObject object 


Description 
Multiple Objects 
HM|IDefaultObjects 
HMlIObjects TubeDoubleTeeObject 
Represents the "Double T-piece" object. The TubeDoubleTeeObject object is an element of 
the following listings: 
e HMlObjects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 
e HM|DefaultObjects: Contains the default property values of all default, smart, window and 
tube objects. 
VBA object name 


HMITubeDoubleTeeObject 


WinCC: Scripting (VBS, ANSI-C, VBA) 
2090 System Manual, 02/2016, A5E37536061-AA 


VBA for Automated Configuration 
3.6 VBA Reference 


Usage 
Use the Add method to create a new "Double T-piece" object in a picture: 
Sub AddTubeDoubleTeeObject () 
"VBA838 
Dim objTubeDoubleTeeObject As HMITubeDoubleTeeObject 
Set objTubeDoubleTeeObject = ActiveDocument.HMIObjects.AddHMIObject ("Double T-piece", 
"HMI TubeDoubleTeeObject") 
End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditTubeDoubleTeeObject () 


"VBA839 

Dim objTubeDoubleTeeObject As HMITubeDoubleTeeObject 

Set objTubeDoubleTeeObject = ActiveDocument.HMIObjects ("Double T-piece") 
obj TubeDoubleTeeObject.BorderColor = RGB(255, 0, 0) 

End Sub 


Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

"VBA840 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name from the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
ObjectName Property (Page 2347) 
Left Property (Page 2305) 
Layer Property (Page 2293) 
Top Property (Page 2446) 
Width Property (Page 2553) 
Height Property (Page 2269) 
BorderColor Property (Page 2153) 
BorderWidth Property (Page 2161) 
ToolTipText Property (Page 2445) 
Visible Property (Page 2551) 
PasswordLevel Property (Page 2362) 
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Operation Property (Page 2353) 
Transparency property (Page 2447) 
GlobalShadow property (Page 2264) 
GlobalColorScheme property (Page 2264) 
Application Property (Page 2121) 
Events Property (Page 2223) 
GroupParent Property (Page 2268) 
LDTooltipTexts Property (Page 2303) 
Parent Property (Page 2359) 

Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Type Property (Page 2450) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


TubePolyline object 


Description 


2092 


HM|IDefaultObjects 
HMlIObjects 


Represents the "TubePolyline" object. The TubePolyline object is an element of the following 
listings: 


TubePolyline 


e HMl|Objects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 


e HM|DefaultObjects: Contains the default property values of all default, smart, window and 
tube objects. 
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VBA object name 
HM TubePolyline 


Usage 


Use the Add method to create a new "TubePolyline" object in a picture: 


Sub AddTubePolyline() 
"VBA841 
Dim objTubePolyline As HMITubePolyline 

Set objTubePolyline = ActiveDocument.HMIObjects.AddHMIObject ("TubePolyline", 
"HMI TubePolyline") 

End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditTubePolyline () 

"VBA842 

Dim objTubePolyline As HMITubePolyline 

Set objTubePolyline = ActiveDocument.HMIObjects ("TubePolyline") 
objTubePolyline.BorderColor = RGB(255, 0, 0) 

End Sub 


Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

"VBA843 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name from the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
ObjectName Property (Page 2347) 
Left Property (Page 2305) 
Layer Property (Page 2293) 
Top Property (Page 2446) 
Width Property (Page 2553) 
Height Property (Page 2269) 
BorderColor Property (Page 2153) 
BorderWidth Property (Page 2161) 
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ToolTipText Property (Page 2445) 
Visible Property (Page 2551) 
PasswordLevel Property (Page 2362) 
Operation Property (Page 2353) 
Transparency property (Page 2447) 
GlobalShadow property (Page 2264) 
GlobalColorScheme property (Page 2264) 
PointCount Property (Page 2379) 
ActualPointLeft Property (Page 2109) 
ActualPointTop Property (Page 2110) 
Index Property (Page 2276) 

Application Property (Page 2121) 
Events Property (Page 2223) 
BorderStyle Property (Page 2160) 
GroupParent Property (Page 2268) 
LDTooltipTexts Property (Page 2303) 
Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Type Property (Page 2450) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


TubeTeeObject object 


Description 


2094 


HM|IDefaultObjects 
HMlIObjects 


TubeTeeObject 
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Represents the "T-piece" object. The TubeTeeObject object is an element of the following lists: 
e HMlObjects: Contains all objects of a picture. 
@ Selection: Contains all selected objects of a picture. 


e HMIDefaultObjects: Contains the default property values of all default, smart, window and 
tube objects. 


VBA object name 
HMITubeT eeObject 


Usage 


Use the Add method to create a new "T-piece" object in a picture: 


Sub AddTubeTeeObject () 
"VBA844 
Dim objTubeTeeObject As HMITubeTeeObject 

Set objTubeTeeObject = ActiveDocument.HMIObjects.AddHMIObject ("T-piece", 
"HMI TubeTeeObject") 

End Sub 


Use "HMlObjects"(Index)" to return an object from the HMIObjects listing, where Index in this 
case identifies the object by name: 


Sub EditTubeTeeObject () 

"VBA845 

Dim objTubeTeeObject As HMITubeTeeObject 

Set objTubeTeeObject = ActiveDocument.HMIObjects ("T-piece") 
obj TubeTeeObject.BorderColor = RGB(255, 0, 0) 

End Sub 


Use "Selection"(Index) to return an object from the Selection listing: 


Sub ShowNameOfFirstSelectedObject () 

"VBA846 

"Select all objects in the picture: 
ActiveDocument.Selection.SelectAll 

"Get the name from the first object of the selection: 
sgBox ActiveDocument.Selection(1) .ObjectName 

End Sub 


See also 
ObjectName Property (Page 2347) 
Left Property (Page 2305) 
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Layer Property (Page 2293) 

Top Property (Page 2446) 

Width Property (Page 2553) 

Height Property (Page 2269) 
BorderColor Property (Page 2153) 
BorderWidth Property (Page 2161) 
ToolTipText Property (Page 2445) 
Visible Property (Page 2551) 
PasswordLevel Property (Page 2362) 
Operation Property (Page 2353) 
Transparency property (Page 2447) 
GlobalShadow property (Page 2264) 
GlobalColorScheme property (Page 2264) 
RotationAngle Property (Page 2400) 
Application Property (Page 2121) 
Events Property (Page 2223) 
GroupParent Property (Page 2268) 
LDTooltipTexts Property (Page 2303) 
Parent Property (Page 2359) 
Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
Type Property (Page 2450) 
ConnectionPoints property (Page 2198) 
ConnectorObjects property (Page 2199) 


VariableStateValue Object 


Description 
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Represents the state of a tag, the value of which is assigned in the Dynamic dialog and used 


VBA Object Name 


See also 


HM VariableStateValue 


VALUE_SERVERDOWN Property (Page 2516) 

VBA Reference (Page 1745) 

VarName Property (Page 2548) 

VALUE_TIMEOUT Property (Page 2520) 
VALUE_STARTUP_VALUE Property (Page 2518) 
VALUE_NOT_ESTABLISHED Property (Page 2514) 
VALUE_MIN_RANGE Property (Page 2512) 
VALUE_MIN_LIMIT Property (Page 2510) 
VALUE_MAX_RANGE Property (Page 2508) 
VALUE_MAX_LIMIT Property (Page 2506) 
VALUE_INVALID_KEY Property (Page 2502) 
VALUE_HARDWARE_ERROR Property (Page 2498) 
VALUE_HANDSHAKE_ERROR Property (Page 2496) 
VALUE_CONVERSION_ERROR Property (Page 2494) 
VALUE_ADDRESS_ERROR Property (Page 2472) 
VALUE_ACCESS_FAULT Property (Page 2470) 
Parent Property (Page 2359) 

Application Property (Page 2121) 


VariableStateValues Object (Listing) 


Description 


A listing of VariableStateValue objects containing all tag statuses in Dynamic dialog to be used 
for dynamization. 
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VBA Object Name 
HMlIVariableStateValues 


Usage 


Use the Item property in the Dynamic dialog to define values that will be used for creating 
dynamics when the specified tag returns the configured state. In the following example the 
radius of a circle is given dynamics with the The dynamization takes place be evaluating the 
status of a tag. If the tag does not return a status, a substitute value (ElseCase property) is 
defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
"'VBA358 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 

-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 
"Activate variable-statecheck 
.VariableStateChecked = Tru 

End With 


With objDynDialog.VariableStateValues (1) 
‘define a value for every state: 
.VALUE_ACCESS FAULT = 20 

. VALUE_ADDRESS ERROR = 30 

. VALUE_CONVERSION_ ERROR = 40 

. VALUE_HANDSHAKE ERROR = 60 

. VALUE HARDWARE ERROR = 70 
.VALUE_INVALID KEY = 80 
.VALUE_MAX LIMIT = 90 

.VALUE_MAX RANGE = 100 

.VALUE_ MIN LIMIT = 110 

.VALUE_MIN RANGE = 120 

. VALUE_NOT_ ESTABLISHED = 130 

.- VALUE_SERVERDOWN = 140 

.- VALUE_STARTUP_ VALUE = 150 

. VALUE TIMEOUT = 160 


End With 
End Sub 


See also 
VALUE_MAX_RANGE Property (Page 2508) 
VBA Reference (Page 1745) 
VarName Property (Page 2548) 
VALUE_TIMEOUT Property (Page 2520) 
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VALUE_STARTUP_VALUE Property (Page 2518) 
VALUE_SERVERDOWN Property (Page 2516) 
VALUE_NOT_ESTABLISHED Property (Page 2514) 
VALUE_MIN_RANGE Property (Page 2512) 
VALUE_MIN_LIMIT Property (Page 2510) 
VALUE_MAX_LIMIT Property (Page 2506) 
VALUE_INVALID_KEY Property (Page 2502) 
VALUE_HARDWARE_ERROR Property (Page 2498) 
VALUE_HANDSHAKE_ERROR Property (Page 2496) 
VALUE_CONVERSION_ERROR Property (Page 2494) 
VALUE_ADDRESS_ERROR Property (Page 2472) 
VALUE_ACCESS_FAULT Property (Page 2470) 
Parent Property (Page 2359) 

Item Property (Page 2283) 

Application Property (Page 2121) 


VariableTrigger Object 


Description 


Represents a tag trigger. 


VBA Object Name 


HMIVariableTrigger 
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Application 


Use the VariableTrigger object in order to edit or delete an existing tag trigger. In this example 
a Circle property "Top" is made dynamic with the aid of the tag "NewDynamic1": 


Sub AddDynamicAsVariableDirectToProperty () 


"VBA359 


Dim objVariable 


Trigger As HMIVariableTrigger 


Dim objCircle As HMICircle 


Set objCircl 
Set objVariablel 


"'NewDynamicl'") 


' 


"Define cycletim 


With objVariableTrigger 


-CycleType 


End With 
End Sub 


See also 


2100 


hmiCycleType 2s 


Delete Method (Page 1831) 
VariableTriggers Object (Listing) (Page 2101) 
VBA Reference (Page 1745) 
VariableTriggers Property (Page 2548) 
Type Property (Page 2450) 

Parent Property (Page 2359) 

Name Property (Page 2343) 
CycleType Property (Page 2209) 
Application Property (Page 2121) 
CycleName Property (Page 2208) 
CycleTime Property (Page 2209) 
VarName Property (Page 2548) 


ActiveDocument .HMIObjects.AddHMIObject ("Circle1l", "HMICircle") 
[rigger = objCircle.Top.CreateDynamic (hmiDynamicCreationTypeVariableDirect, 
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VariableTriggers Object (Listing) 


Description 

A listing of the VariableTrigger objects that represent all the tag triggers in use. 
VBA Object Name 

HM IVariableTriggers 
Usage 


Use the Add method to create a new tag trigger. In the following example the radius of a circle 
is made dynamic with the aid of a VB script. A tag trigger is used as the trigger: 


Sub DynamicWithVariableTriggerCycle() 

"VBA360 

Dim objVBScript As HMIScriptInfo 

Dim objVarTrigger As HMIVariableTrigger 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument .HMIObjects.AddHMIObject ("Circle VariableTrigger", 
"HMICircle") 

Set objVBScript = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeVBScript) 
With objVBScript 

"Definition of triggername and cycletime is to do with the Add-methode 

Set objVarTrigger = .Trigger.VariableTriggers.Add("VarTrigger", hmiVariableCycleType 10s) 
-SourceCode = "™ 

End With 

End Sub 


See also 
Add Method (TagTriggers Listing) (Page 1792) 
VBA Reference (Page 1745) 
Parent Property (Page 2359) 
Item Property (Page 2283) 
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Count Property (Page 2201) 
Application Property (Page 2121) 


View Object 
Description 
Represents a copy of a picture. The View object is an element of the Views listing. 
You can use the properties of the View object among other things to control the visibility of the 
CS layers and to define the zoom. 
VBA Object Name 
HMIView 
Usage 


Use Views(Index) to return an individual View object. In the following example the number of 
copies of the active picture will be output: 


Sub ShowNumberOfExistingViews () 

"VBA361 

Dim iMaxViews As Integer 

iMaxViews = ActiveDocument.Views.Count 

MsgBox "Number of copies from active document: " & iMaxViews 
End Sub 


Use the Add method to add a new View object to the "Views" listing. In the following example 
a copy of the active picture is created and then activated: 


Sub AddView() 

"VBA362 

Dim objView As HMIView 

Set objView = ActiveDocument.Views.Add 
objView.Activate 

End Sub 
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See also 
Height Property (Page 2269) 
Views Object (Listing) (Page 2103) 
SetCSLayerVisible Method (Page 1885) 
PrintDocument Method (Page 1869) 
IsCSLayerVisible Method (Page 1857) 
Delete Method (Page 1831) 
Add Method (Views Listing) (Page 1793) 
Activate Method (Page 1785) 
VBA Reference (Page 1745) 
Editing a Copy of a Picture with VBA (Page 1658) 
Editing Layers with VBA (Page 1657) 
ExtendedZoomingEnable Property (Page 2228) 
Zoom Property (Page 2559) 
WindowState Property (Page 2557) 
Width Property (Page 2553) 
Top Property (Page 2446) 
ScrollPosY Property (Page 2411) 
ScrollPosX Property (Page 2410) 
Parent Property (Page 2359) 
Left Property (Page 2305) 
IsActive Property (Page 2279) 
Application Property (Page 2121) 
ActiveLayer Property (Page 2108) 


Views Object (Listing) 


Description 


A listing of the View objects that represent a copy of a picture. 
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VBA Object Name 
HMIViews 


Usage 


Use the Views listing to return a View object. In the following example the number of existing 
copies of the active picture will be output: 


Sub ShowNumberOfExistingViews () 

'VBA363 

Dim iMaxViews As Integer 

iMaxViews = ActiveDocument.Views.Count 

sgBox "Number of copies from active document: " & iMaxViews 
End Sub 


Use the Add method to create a copy of a picture. In the following example a copy of the active 
picture is created and then activated: 


Sub AddViewToActiveDocument () 

"VBA364 

Dim objView As HMIView 

Set objView = ActiveDocument.Views.Add 
objView.Activate 

End Sub 


See also 

Item Method (Page 1859) 

View Object (Page 2102) 

Add Method (Page 1786) 

VBA Reference (Page 1745) 
Parent Property (Page 2359) 
Count Property (Page 2201) 
Application Property (Page 2121) 


WPF Control object 


Description 


Represents the "WPFControl" object. The WPFControl object is an element of the following 
listings: 


e HMlObjects: Contains all objects of a picture. 


@ Selection: Contains all selected objects of a picture. 
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VBA Object Name 
HMIWPF Control 


Application 
Use the AddWPF Control method to insert a WPFControl in a picture. 
In the following example, the "WPF Control" object outside the Global Assembly Cache is 
inserted in the active picture. 
"VBA852 


Dim WPFControl As HMIWPFControl 
Set WPFControl = ActiveDocument.HMIObjects.AddWPFControl ("MyWPFVBAControl", 
"WinCCWPFControl.TestControl", False, "Assembly=Z:\TestControl\WinCCWPFControl.dll") 


See also 
AddWPF Control method (Page 1806) 
Delete Method (Page 1831) 
Application Property (Page 2121) 
Assemblylnfo property (Page 2122) 
ControlType property (Page 2201) 
Events Property (Page 2223) 
GroupParent Property (Page 2268) 
Height Property (Page 2269) 
Layer Property (Page 2293) 
LDTooltipTexts Property (Page 2303) 
Left Property (Page 2305) 
ObjectName Property (Page 2347) 
Operation Property (Page 2353) 
Parent Property (Page 2359) 
PasswordLevel Property (Page 2362) 
Properties Property (Page 2388) 
Selected Property (Page 2412) 
TabOrderSwitch Property (Page 2433) 
TabOrderAlpha Property (Page 2429) 
ToolTipText Property (Page 2445) 
Top Property (Page 2446) 
Type Property (Page 2450) 
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Visible Property (Page 2551) 
Width Property (Page 2553) 
ConnectorObjects property (Page 2199) 


3.6.1.8 Properties 


A 


Actions Property 


Description 
Returns the Actions listing. Use the Actions property to configure an event-driven action. 


Example: 


In this example a button and a circle will be inserted in the active picture. In Runtime the radius 
of the circle enlarges every time you click the button: 


Sub CreateVBActionToClickedEvent () 
"VBA365 
Dim objButton As HMIButton 
Dim objCircle As HMICircle 
Dim objEvent As HMIEvent 
Dim objVBScript As HMIScriptInfo 
Set objCircle = ActiveDocument .HMIObjects.AddHMIObject ("Circle VB", "HMICircle") 
Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMTButton") 
With objCircle 
-Top = 100 
-Left = 100 
-BackColor = RGB(255, 0, O) 
End With 
With objButton 
-Top = 10 
-Left = 10 
-Width = 120 
Text = "Increase Radius" 
End With 
"Define event and assign sourcecode: 
Set objVBScript = objButton.Events(1).Actions.AddAction (hmiActionCreationTypeVBScript) 
With objVBScript 


-SourceCode = "Dim myCircle" & vbCrLf & _ 
"Set myCircle = HMIRuntime.ActiveScreen.ScreenItems(""Circle VB"™")" & _ 
vbCrLf & "myCircle.Radius = myCircle.Radius + 5" 

End With 

End Sub 
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See also 
Actions Object (Listing) (Page 1898) 
AddAction Method (Page 1794) 
Configuring Event-Driven Actions with VBA (Page 1699) 
ActionType property 
Description 
Only used internally. 
See also 


VBA Reference: ActionDynamic (Page 1747) 


ActiveDocument Property 


Description 


Returns an object of the "Document" type which represents the active picture in the Graphics 
Designer. If there is no open or active picture in the Graphics Designer, you receive an error 
message. 


Note 


The "ActiveDocument" property refers to the window that possesses the input focus. If other 
editors (e.g. CrossReference) access a picture, the input focus can change. To prevent this 
situation leading to errors, reference the picture unambiguously via the Documents listing. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 2107 


VBA for Automated Configuration 


3.6 VBA Reference 


Example: 


The "CreateMenultem()" procedure creates the "Delete Objects" menu and adds two menu 
entries ("Delete Rectangles" and "Delete Circles"). 


Sub CreateMenulItem () 


"VBA366 


Dim objMenu As HMIMenu 
Dim objMenuItem As HMIMenuItem 


"Create new menu "Delete Objects": 


Set objMenu = ActiveDocument.CustomMenus.InsertMenu(1, "DeleteObjects", "Delete Objects") 


' 


‘Add two menuitems to the menu "Delete Objects 


Set objMenuItem = objMenu.Menultems.InsertMenuItem(1, "DeleteAllRectangles", "Delet 


Rectangles") 
Set objMenulItem = objMenu.MenuItems.InsertMenuItem(2, "DeleteAllCircles", "Delete Circles") 
End Sub 
See also 
Documents Object (Listing) (Page 1952) 
ActiveLayer Property 
Description 
Defines or returns the active layer for the View object. The value range is from 0 to 31, where 
"0" represents the uppermost layer and "31" the lowest layer. 
Example: 


The "ActiveDocumentConfiguration()" procedure accesses the properties of the current picture 
in the Graphics Designer. In this example a new View object is created and layer 1 is set to 
"Active": 


Sub ActiveDocumentConfiguration() 


"VBA367 

Application. ActiveDocument.Views.Add 

Application.ActiveDocument.Views(1).ActiveLayer = 2 

End Sub 
See also 

View Object (Page 2102) 
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ActualPointLeft Property 


Description 


Defines or returns the X coordinate of the current corner point by reference to the picture origin 
(top left) for the objects "Polygon" and "Polyline". Each corner point is identified by an index 
which is derived from the number ("PointCount") of corner point available. 


A change of the value can affect the properties "Width" (object width) and "Left" (x-coordinate 
of the object position). 


Example: 


The "PolygonCoordinatesOutput()" procedure outputs the coordinates of all the corner points 
in the first polyline in the current picture: 


Sub PolygonCoordinatesOutput () 
"VBA368 

Dim objPolyline As HMIPolyLine 
Dim iPosX As Integer 

Dim iPosY As Integer 

Dim iCounter As Integer 

Dim strResult As String 


iCounter = 1 

Set objPolyline = ActiveDocument.HMIObjects.AddHMIObject ("Polylinel", "HMIPolyLine") 
For iCounter = 1 To objPolyline.PointCount 

With objPolyline 

-index = iCounter 

iPosX = .ActualPointLeft 

iPosY = .ActualPointTop 

End With 

strResult = strResult & vbCrLf & "Corner " & iCounter & ": x=" & iPosxX & " y=" & iPosY 


ext iCounter 
sgBox strResult 
End Sub 


See also 
PointCount Property (Page 2379) 
Index Property (Page 2276) 
ActualPointTop Property (Page 2110) 
PolyLine Object (Page 2038) 
Polygon Object (Page 2035) 
Line Object (Page 2004) 
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ActualPointTop Property 


Description 


Defines or returns the Y coordinate of the current corner point by reference to the picture origin 
(top left) for the objects "Polygon" and "Polyline". Each corner point is identified by an index 
which is derived from the number ("PointCount") of corner point available. 


Achange of the value can affect the properties "Height" (object height) and "Top" (y-coordinate 
of the position). 


Example: 


The "Polygon()" procedure outputs the coordinates of all the corner points in the first polyline 
in the current picture: 


Sub PolygonCoordinatesOutput () 
"VBA369 

Dim objPolyline As HMIPolyLine 
Dim iPosX As Integer 

Dim iPosY As Integer 

Dim iCounter As Integer 

Dim strResult As String 


iCounter = 1 

Set objPolyline = ActiveDocument.HMIObjects.AddHMIObject ("Polylinel", "HMIPolyLine") 
For iCounter = 1 To objPolyline.PointCount 

With objPolyline 

-index = iCounter 

iPosX = .ActualPointLeft 

iPosY = .ActualPointTop 

End With 

strResult = strResult & vbCrLf & "Corner " & iCounter & ": x=" & iPosxX & " y=" & iPosY 


ext iCounter 
sgBox strResult 
End Sub 


See also 
PointCount Property (Page 2379) 
Index Property (Page 2276) 
ActualPointLeft Property (Page 2109) 
PolyLine Object (Page 2038) 
Polygon Object (Page 2035) 
Line Object (Page 2004) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
2110 System Manual, 02/2016, ASE37536061-AA 


VBA for Automated Configuration 
3.6 VBA Reference 


AdaptBorder Property 


Description 


TRUE if the field border is intended to adapt dynamically to the size of the text. BOOLEAN 
write-read access. 


Note 
Changing the contents of a field dynamically can cause pumping in the field. 


Performance is improved in Runtime by using "AdaptBorder = False". 


Example: 


The "lOFieldConfiguration()" procedure accesses the properties of the I/O field. In this example 
the text size is dynamically adapted to the field size. 


Sub I0FieldConfiguration () 
"VBA372 

Dim objJIOField As HMIIOField 
' 


"Add new I0-Feld to active document: 


Set obj1IOField = ActiveDocument.HMIObjects.AddHMIObject ("IOField1i", "HMIIOField") 
With obj1IOField 
-AdaptBorder = True 


End With 
End Sub 
See also 
OptionGroup Object (Page 2025) 
TextList Object (Page 2076) 
StaticText Object (Page 2067) 
IOField Object (Page 1992) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 
AdaptPicture Property 
Description 


TRUE if the picture size is to be adapted to the picture window size. BOOLEAN write-read 
access. 
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Example: 


The "PictureWindowConfig" procedure accesses the properties of the picture window. In this 
example the picture window will be configured: 


Sub PictureWindowConfig() 

'VBA373 

Dim objPicWindow As HMIPictureWindow 

od 

"Add new picturewindow into active document: 

Set objPicWindow = ActiveDocument.HMIObjects.AddHMIObject ("PicWindowl", "HMIPictureWindow") 
With objPicWindow 

-AdaptPicture = False 

-AdaptSize = False 

-Caption = True 


-CaptionText = "Picturewindow in runtime" 
-OffsetLeft = 5 
-OffsetTop = 10 


"Replace the picturename "Test.PDL" with the name of 

‘an existing document from your "GraCS"-Folder of your active project 
-PictureName = "Test.PDL" 

-ScrollBars = True 

.ServerPrefix = ™" 

-TagPrefix = "Struct." 

-UpdateCycle = 5 

-Zoom = 100 

End With 

End Sub 


See also 
PictureWindow Object (Page 2029) 


AdaptSize Property 


Description 


TRUE if the picture window size is to be adapted to the picture size. BOOLEAN write-read 
access. 
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The "PictureWindowConfig" procedure accesses the properties of the picture window. In this 


example the picture window will be configured: 


Sub PictureWindowConfig() 
"'VBA374 
Dim objPicWindow As HMIPictureWindow 


"Add new picturewindow into active document: 


Set objPicWindow = ActiveDocument.HMIObjects.AddHMIObject ("PicWindowl", 


With objPicWindow 

-AdaptPicture = False 

-AdaptSize = False 

-Caption = True 

-CaptionText = "Picturewindow in runtime" 
-OffsetLeft = 5 

-OffsetTop = 10 


"Replace the picturename "Test.PDL" with the name of 

‘an existing document from your "GraCS"-Folder of your active project 
.-PictureName = "Test.PDL" 

-ScrollBars = True 

.ServerPrefix = ™" 

-TagPrefix = "Struct." 

-UpdateCycle = 5 

-Zoom = 100 

End With 

End Sub 


See also 
PictureWindow Object (Page 2029) 


Addins property 


Description 


Only used internally. 


See also 
Application Object (Page 1909) 
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AlarmGoneVisible property 


Description 


Defines whether an outgoing state is visible. 


Assigned Value Description 
True The outgoing state is visible. 
False The outgoing state is suppressed. 


AlarmHigh Property 


Description 
Defines the top limit value at which an alarm should be triggered or returned. 
The type of the evaluation (in percent or absolute) is defined in the "TypeAlarmHigh" property. 
The "CheckAlarmHigh" property defines whether the monitoring function for the limit value is 
activated. 

Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the high limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "50". 


Sub BarGraphLimitConfiguration () 
"VBA375 

Dim objBarGraph As HMIBarGraph 

' 

"Add new BarGraph to active document: 
Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis to absolut 
.TypeAlarmHigh = False 

"Activate monitoring 

.CheckAlarmHigh = True 

"Set barcolor to "yellow" 
-ColorAlarmHigh = RGB(255, 255, 0) 
"set upper limit to "50" 

-AlarmHigh = 50 

End With 

End Sub 
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See also 
TypeAlarmHigh Property (Page 2451) 
ColorAlarmHigh Property (Page 2182) 
CheckAlarmHigh Property (Page 2170) 
BarGraph Object (Page 1914) 


AlarmLow Property 


Description 
Defines the bottom limit value at which an alarm should be triggered or returned. 
The type of the evaluation (in percent or absolute) is defined in the "TypeAlarmLow" property. 


The "CheckAlarmLow" property defines whether the monitoring function for the limit value is 
activated. 


Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the low limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "10". 


Sub BarGraphLimitConfiguration () 
"VBA376 

Dim objBarGraph As HMIBarGraph 

' 


‘Add new BarGraph to active document: 
Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis to absolut 
.TypeAlarmLow = False 

"Activate monitoring 

-CheckAlarmLow = True 

"Set Barcolor to "yellow" 
-ColorAlarmLow = RGB(255, 255, 0) 
"set lower limit to "10" 

-AlarmLow = 10 

End With 

End Sub 


See also 
TypeAlarmLow Property (Page 2452) 
ColorAlarmLow Property (Page 2183) 
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CheckAlarmLow Property (Page 2171) 
BarGraph Object (Page 1914) 


Alignment Property 


Description 
Defines or returns the scale display (left/right or top/bottom) depending on the position of the 
BarGraph object. The Scaling property must be set to TRUE for the scale to be displayed. 
Display Assigned Value 
Right or bottom TRUE 
Left or top FALSE 
Example: 


The "BarGraphConfiguration()" procedure configures In this example the scale is to be located 
to the right of the bar: 


Sub BarGraphConfiguration() 

"VBA377 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "“HMIBarGraph") 


With objBarGraph 


-Alignment = True 
-Scaling = True 
End With 

End Sub 

See also 


Scaling Property (Page 2405) 
Direction Property (Page 2213) 
BarGraph Object (Page 1914) 
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Description 
Defines or returns the horizontal alignment of the text. Value range from 0 to 2. 
Horizontal Alignment Assigned Value 
Left 0 
Centered 1 
Right 2 
Example: 


The "lOFieldConfiguration()" procedure accesses the properties of the I/O field. In this example 
the text in the I/O field will be centered horizontally: 


Sub I0FieldConfiguration () 
'VBA378 


Dim objJIOField As HMIIOField 


Set obj1IOField = ActiveDocument.HMIObjects.AddHMIObject ("IOFieldl", 


With objIOField 
-AlignmentLeft = 1 
End With 

End Sub 


Related topics 


See also 
AlignmentTop Property (Page 2118) 
TextList Object (Page 2076) 
StaticText Object (Page 2067) 
OptionGroup Object (Page 2025) 
GroupDisplay Object (Page 1980) 
IOField Object (Page 1992) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 
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AlignmentTop Property 


Description 
Defines or returns the vertical alignment of the text. Value range from 0 to 2. 
Horizontal Alignment Assigned Value 
Up 0 
Centered 1 
Down 2 
Example: 


The "IOFieldConfiguration()" procedure accesses the properties of the I/O field. In this example 
the text in the I/O field will be centered in the middle: 


Sub IOFieldConfiguration () 

"VBA379 

Dim objJIOField As HMIIOField 

Set obj1IOField = ActiveDocument.HMIObjects.AddHMIObject ("IOField1i", "HMIIOField") 
With obj1IOField 

-AlignmentLeft = 1 

-AlignmentTop = 1 

End With 

End Sub 


See also 
AlignmentLeft Property (Page 2117) 
TextList Object (Page 2076) 
StaticText Object (Page 2067) 
OptionGroup Object (Page 2025) 
GroupDisplay Object (Page 1980) 
lOField Object (Page 1992) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 


AnalogResultinfos Property 


Description 


Returns the AnalogResultInfos listing. Use the AnalogResultInfos property to define value 
ranges and property values in the Dynamic dialog. 
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Example: 
An example showing how to use the AnalogResultInfos property can be found in this 
documentation under the heading "AnalogResultInfos Object (Listing)”. 
See also 
DynamicDialog Object (Page 1955) 
AnalogResultInfos Object (Listing) (Page 1908) 
AngleAlpha Property 
Description 
Defines or returns depth angle a for the 3D-effect of the "3DBarGraph" object. Value range in 
degrees from 0 to 90. 
Example: 


The "HMI3DBarGraphConfiguration()" procedure accesses the properties of the 3DBarGraph 
object. In this example depth angles A and B will be assigned the values "15" and 45: 


Sub HMI3DBarGraphConfiguration () 
"VBA380 

Dim obj3DBar As HMI3DBarGraph 
Set obj3DBar = ActiveDocument.HMIObjects.AddHMIObject ("3DBar1", "HMI3DBarGraph") 
With obj3DBar 

"Depth-angle a = 15 degrees 
-AngleAlpha = 15 

"Depth-angle b = 45 degrees 
-AngleBeta = 45 

End With 

End Sub 
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See also 
AngleBeta Property (Page 2120) 
3DBarGraph Object (Page 1894) 
AngleBeta Property 
Description 
Defines or returns depth angle b for the 3D-effect of the "3DBarGraph" object. Value range in 
degrees from 0 to 90. 
Example: 


The "HMI3DBarGraphConfiguration()" procedure accesses the properties of the 3DBarGraph 
object. In this example depth angles A and B will be assigned the values "15" and 45: 


Sub HMI3DBarGraphConfiguration () 

'VBA381 

Dim obj3DBar As HMI3DBarGraph 

Set obj3DBar = ActiveDocument.HMIObjects.AddHMIObject ("3DBar1i", "HMI3DBarGraph") 
With obj3DBar 

"Depth-angle a = 15 degrees 

-AngleAlpha = 15 

"Depth-angle b = 45 degrees 

-AngleBeta = 45 


End With 
End Sub 
See also 
AngleAlpha Property (Page 2119) 
3DBarGraph Object (Page 1894) 
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Application Property 


Description 
Returns the Graphics Designer application when the application property is used without an 
object identifier. If the application property is used with object identifier, it returns an application 
object which displays the application with which the defined object was created. Read only 
access. 

Example: 


In this example an Excel object is created and the application name is output: 


Sub CreateExcelApplication () 
"VBA382 


"Open Excel invisible 

Dim objJExcelApp As New Excel .Application 
sgBox objExcelApp 

"Delete the reference to Excel and close it 
Set objExcelApp = Nothing 

End Sub 


See also 


Application Object (Page 1909) 
ApplicationDataPath Property 


Description 


Returns the complete path of the active picture in the Graphics Designer. Read-only access. 


Example: 


The "ShowApplicationDataPath()" procedure outputs the path of the current picture: 
Sub ShowApplicationDataPath () 
"VBA383 


MsgBox Application.ApplicationDataPath 
End Sub 
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Graphics Designer Xi 


C:\Siemens\wWinCC\WinCCProjects\mytestproject\GraCs} 


See also 
Application Property (Page 2121) 
Application Object (Page 1909) 
Assemblyinfo property 
Description 


Displays the information of the object registered in the Global Assembly Cache. The 
information is made up of "Assembly", "Version", "Culture" and "PublicKeyToken". 


If the object is not registered in the Global Assembly Cache, the path of the object is only 
displayed in "Assembly". 


Assignments Property 


Description 


Example: 


See also 
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A list which contains the assignments between the output values and the actual output texts 
to be output. 


The assignments are dependent on the list type set. The list type is defined with the ListType 
property. 


The number of entries depends on the total length of the string passed to the "Assignments" 
property. This string cannot be longer than 500,000 bytes. This may be checked prior to 
dropping access to the "Assignments" property by using the function LenB(). 


ListType Property (Page 2312) 


TextList Object (Page 2076) 
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AssumeOnExit Property 


Description 


TRUE, if the entered text is assumed after exiting the input field (by using the <TAB> key or 
mouse Click, for example). BOOLEAN write-read access. 


Example: 


The "|OFieldConfiguration()" procedure accesses the properties of the I/O field. In this example 
the text that has been entered will be taken over as input on exit from the input field. 


Sub I0FieldConfiguration () 

"VBA385 

Dim objIOField As HMIIOField 

Set obj1IOField = ActiveDocument.HMIObjects.AddHMIObject ("IOField1i", "HMIIOField") 
With obj1IOField 

-AssumeOnExit = True 

End With 

End Sub 


See also 
TextList Object (Page 2076) 
lOField Object (Page 1992) 


AssumeOnFull Property 


Description 


TRUE, when the content of the input field is full (specified number of characters have been 
entered) and should be exited automatically and the input accepted. BOOLEAN write-read 
access. 
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Example: 


The "lOFieldConfiguration()" procedure accesses the properties of the I/O field. In this example 
the text that has been entered will be taken over as input on exit from the input field. 


Sub IO0FieldConfiguration () 


"VBA386 


Dim objJIOField As HMIIOField 
Set obj1IOField = ActiveDocument.HMIObjects.AddHMIObject ("IOField1i", "HMIIOField") 
With objIOField 


-AssumeOnFull 


End With 
End Sub 


See also 


= True 


OutputFormat Property (Page 2357) 
DataFormat Property (Page 2210) 


lOField Object (Page 1992) 


AutomationName Property 


Description 


2124 


Depending on the source and destination object types for the direct connection, either defines 


or returns the name of a property. 


The two tables show you when you must use the AutomationName property. A"--" means that 
the property is assigned an empty string (") by default when the DirectConnection object is 


created. 


Source object type (SourceLink Property) 


Type Property 


hmiSourceTypeConstant 


AutomationName Property 


ObjectName Property 


Name of the constant (e.g. the 
picture name) 


hmiSourceTypeProperty 


Property of the source object 
(e.g. "Top") 


Name of the source object (e.g. 
"Rectangle_A") 


hmiSourceTypePropertyOfThi- 
sObject 


hmiSourceTypeVariableDirect 


Tag name 


hmiSourceTypeVariablelndirect 


Tag name 
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Destination object type (DestinationLink Property) 


Type Property AutomationName Property ObjectName Property 

hmiDestTypeProperty Property of the destination ob- | Name of the destination object 
ject (e.g. "Left") (e.g. "Rectangle_A") 

hmiDestTypePropertyOfThisObject | -- -- 

hmiDestTypePropertyOfActual- Property of the destination ob- | -- 

Window ject (e.g. "Left") 

hmiDestTypeVariableDirect -- Tag name 

hmiDestTypeVariablelndirect -- Tag name 

hmiDestTypeDirectMessage -- Tag name 

hmiDestTypelndirectMessage -- Tag name 
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Example: 


In the following example the X position of "Rectangle_A" is copied to the Y position of 


"Rectangle_B" in Runtime by clicking on the button: 


Sub DirectConnection () 

'VBA387 

Dim objButton As HMIButton 

Dim objRectangleA As HMIRectangle 
Dim objRectangleB As HMIRectangle 
Dim objEvent As HMIEvent 


Dim objDynConnection As HMIDirectConnection 


"Add objects to active document: 


Set objRectangleA = ActiveDocument.HMIObjects.AddHMIObject ("Rectangle A", "HMIRectangle") 
Set objRectangleB = ActiveDocument.HMIObjects.AddHMIObject ("Rectangle B", "HMIRectangle") 
Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMTButton") 


With objRectangleA 
-Top = 100 
-Left = 100 


With objRectangleB 

-Top = 250 

-Left = 400 

-BackColor = RGB(255, 0, O) 
End With 
With objButton 


m op = 1 0 
-Left = 10 
-Text = "SetPosition" 
End With 
' 


"Directconnection is initiate by mouseclick: 


Set objDynConnection = 


to position and configure objects: 


objButton.Events (1) .Actions.AddAction (hmiActionCreationTypeDirectConnection) 


With objDynConnection 


"Sourceobject: Top-Property of Rectangle A 
-SourceLink.Type = hmiSourceTypeProperty 
-SourceLink.ObjectName = "Rectangle A" 


-SourceLink.AutomationName = "Top" 
' 


"Targetobject: Left-Property of Rectangle B 


.DestinationLink.Type = hmiDestTypeProperty 
.DestinationLink.ObjectName = "Rectangle B" 
.DestinationLink.AutomationName = "Left" 
End With 

End Sub 
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See also 
DestinationLink Property (Page 2211) 
Type Property (Page 2450) 
SourceLink Property (Page 2422) 
ObjectName Property (Page 2347) 
SourceLink Object (Page 2065) 
DestLink Object (Page 1945) 


AvailableDataLanguages Property 


Description 


Returns a listing of the available project languages. 


Example: 


The "AusgabetDataLanguages()" procedure outputs all the existing project languages together 
with their language identifiers (as a decimal value): 


Sub OutputDataLanguages () 

"VBA388 

Dim colDataLang As HMIDataLanguages 
Dim objDataLang As HMIDataLanguage 
Dim strLangList As String 

Dim iCounter As Integer 


"Save collection of datalanguages 

‘into variable "colDataLang" 

Set colDataLang = Application.AvailableDataLanguages 
iCounter = 1 

' 

"Get every languagename and the assigned ID 

For Each objDataLang In colDataLang 

With objDataLang 


If 0 = iCounter Mod 3 Or 1 = iCounter Then 

strLangList = strLangList & vbCrLf & .LanguageID & " " & .LanguageName 
Else 

strLangList = strhLanghlist & " / " & .LanguageID & " " & .LanguageName 
End If 
End With 

iCounter = iCounter + 1 

ext objDataLang 

sgBox strLangList 
End Sub 
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See also 
LanguageName Property (Page 2290) 
LanguagelD Property (Page 2289) 
How to assign help texts to menus and toolbars (Page 1639) 
How to create menus in multiple languages (Page 1633) 


Language-Dependent Configuration with VBA (Page 1624) 
Average Property 


Description 


TRUE, if the mean value is calculated based on the last 10 values. A value change is 
conditional for calculation of a new mean value. The mean value is reset when you change a 
picture. If only one value is available when you change the picture, the following mean value 
is calculated: (5+0+0+0+0+0+0+0+0+0)/10=0,5. 


BOOLEAN write-read access. 


Example 


The "BarGraphConfiguration()" procedure configures In this example, value averaging will be 
activated: 


Sub BarGraphConfiguration() 

"VBA389 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

-Average = True 

End With 

End Sub 


See also 
BarGraph Object (Page 1914) 
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Axe Property 

Description 
Defines or returns the axis for displaying the measured value. Value range from 0 to 2. 
Axis Assigned Value 
X 0 
Y 1 
Z 2 

Example: 


The "HMI3DBarGraphConfiguration()" procedure accesses the properties of the 3DBarGraph 
object. In this example the Y axis for displaying the measured value will be defined: 


Sub HMI3DBarGraphConfiguration () 
"VBA390 


Dim obj3DBar As HMI3DBarGraph 


Set obj3DBar = ActiveDocument.HMIObjects.AddHMIObject ("3DBar1", "HMI3DBarGraph") 
With obj3DBar 

-Axe = 1 

End With 

End Sub 


See also 


3DBarGraph Object (Page 1894) 
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AxisSection Property 


Description 


Example 


See also 
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Defines or returns the distance between two long axis sections. The information on the distance 
is given in scale units and is dependent on the minimum and maximum values configured. 


BarGraph Object (Minimum/Maximum Value: -5/5; AxisSection = 2) 


The "BarGraphConfiguration()" procedure accesses the properties of the BarGraph object. In 
this example the axis section will be set to "2". 


Sub BarGraphConfiguration () 
"VBA391 
Dim objBar As HMIBarGraph 


Set objBar = ActiveDocument.HMIObjects.AddHMIObject ("Barl", 
"HMIBarGraph") 


With objBar 
-AxisSection = 2 


End With 


End Sub 


BarGraph Object (Page 1914) 
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B 

BackBorderWidth Property 

Description 
Defines or returns the width of the 3D border in pixels. The value for the width is dependent 
on the size of the object. 
Slider 
Defines or returns the width of the border in pixels. BackBorderWidth = 0 prevents the border 
being displayed on the Slider object. 

Example: 


The "ButtonConfiguration()" procedure accesses the properties of the button. In this example 
the width of the 3D border will be set to "2". 


Sub ButtonConfiguration () 

"VBA392 

Dim objButton As HMIButton 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Button1l", "“HMIButton") 
With objButton 

-BackBorderWidth = 2 


End With 
End Sub 
See also 
Slider object (Page 2062) 
RoundButton Object (Page 2052) 
GroupDisplay Object (Page 1980) 
Button Object (Page 1921) 
BackColor Property 
Description 


Defines or returns the background color for the object. LONG read-write access. 


The background color is not displayed if "transparent" is defined as the fill pattern. 
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Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 


represented as follows: RGB(255, 0, 0) 


Example: 


The "RectangleConfiguration()" procedure accesses the properties of the rectangle. In this 


example the background color will be set to "Yellow". 


Sub RectangleConfiguration () 


"VBA393 


Dim objRectangle As HMIRectangle 


Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 


With objRectangle 
-BackColor = RGB(255, 255, 
End With 


End Sub 


See also 
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EllipseSegment Object (Page 1963) 
StaticText Object (Page 2067) 
Slider object (Page 2062) 

TextList Object (Page 2076) 


RoundRectangle Object (Page 2055) 


RoundButton Object (Page 2052) 
Rectangle Object (Page 2049) 
Polygon Object (Page 2035) 
PieSegment Object (Page 2032) 
OptionGroup Object (Page 2025) 
GroupDisplay Object (Page 1980) 
GraphicObject Object (Page 1975) 
IOField Object (Page 1992) 
Ellipse Object (Page 1957) 
Document Object (Page 1949) 
Circle Object (Page 1928) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 
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BarGraph Object (Page 1914) 
3DBarGraph Object (Page 1894) 


BackColor2 Property 


Description 
Defines or returns the bar color for the display of the current value. LONG write-read access. 
Determination of Color Value 
The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 

Example: 


The "BarGraphConfiguration()" procedure configures In this example the bar color for 
displaying the current value will be set to "Yellow": 


Sub BarGraphConfiguration() 

"VBA394 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "“HMIBarGraph") 
With objBarGraph 

-BackColor2 = RGB(255, 255, 0) 


End With 
End Sub 
See also 
BarGraph Object (Page 1914) 
BackColor3 Property 
Description 


Defines or returns the color of the bar background. LONG write-read access. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
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Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


Example: 


The "BarGraphConfiguration()" procedure configures In this example the color of the bar 
background will be set to "Blue": 


Sub BarGraphConfiguration() 

"VBA395 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

-BackColor3 = RGB(O0, 0O, 255) 

End With 

End Sub 


See also 
BarGraph Object (Page 1914) 


BackColor_Alarm.._Warning property 


Description 
Defines the color used for the background of one of the following states or message types: 
e Alarm 
e Warning 
e Tolerance 
e AS Process Control Error 
e AS Control System Fault 
e Operator request 
e OK 


e Simulation 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
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BackColorBottom Property 


Description 


Defines or returns the color for the bottom/right part of the slider. LONG write-read access. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


Example: 


The "SliderConfiguration()" procedure accesses the properties of the slider. In this example 
the color of the bottom part of the slider will be set to "Blue": 


Sub SliderConfiguration() 

"VBA396 

Dim objSlider As HMISlider 

Set objSlider = ActiveDocument.HMIObjects.AddHMIObject ("SliderObject1i", "HMISlider") 
With objSlider 

-BackColorBottom = RGB(O, 0, 255) 


End With 
End Sub 
See also 
Slider object (Page 2062) 
BackColorTop Property 
Description 


Defines or returns the color for the top/left part of the slider. LONG write-read access. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
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Example: 


The "SliderConfiguration()" procedure accesses the properties of the slider. In this example 
the color of the top part of the slider will be set to "Yellow": 


Sub SliderConfiguration() 

'VBA397 

Dim objSlider As HMISlider 

Set objSlider = ActiveDocument.HMIObjects.AddHMIObject ("SliderObject1i", "HMISlider") 
With objSlider 

-BackColorTop = RGB(255, 255, 0) 

End With 

End Sub 


See also 
Slider object (Page 2062) 


BackFillColor property 


Description 


Defines the color with which the background is filled at an advanced analog display. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


BackFillColor_OK property 


Description 


Defines the color with which the background is filled at the state "OK". 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
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BackFillColor_Simulation property 


Description 


Defines the color with which the background is filled at the "Simulation" state. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


BackFillStyle property 


Description 
Defines the pattern with which the background is filled at an advanced analog display. 


There is a choice of 50 fill patterns. The fill pattern 0 "Solid" fills the object with the set 
background color; the fill pattern 1 "Transparent" defines that neither a background nor a fill 
pattern is displayed. 


BackFillStyle_OK property 


Description 
Defines the pattern with which the background is displayed at the state "OK". 


There is a choice of 50 fill patterns. The fill pattern 0 "Solid" fills the object with the set 
background color; the fill pattern 1 "Transparent" defines that neither a background nor a fill 
pattern is displayed. 


BackFillStyle_Simulation property 


Description 
Defines the pattern with which the background is displayed at the "Simulation" state. 


There is a choice of 50 fill patterns. The fill pattern 0 "Solid" fills the object with the set 
background color; the fill pattern 1 "Transparent" defines that neither a background nor a fill 
pattern is displayed. 
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BackFlashColorOff Property 


Description 


Example: 


Defines or returns the color of the object background for the flash status "Off". LONG write- 


read access. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 


represented as follows: RGB(255, 0, 0) 


The "RectangleConfiguration()" procedure accesses the properties of the rectangle. In this 
example the color when the flash status is "Off" will be set to "Yellow": 


Sub RectangleConfiguration () 


"VBA398 


Dim objRectangle As HMIRectangle 


Set objRectangl 


= ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 


With objRectangle 
-BackFlashColorOff = RGB(255, 255, 0) 


End With 
End Sub 


See also 
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BarGraph Object (Page 1914) 
StaticText Object (Page 2067) 
Slider object (Page 2062) 

TextList Object (Page 2076) 
RoundRectangle Object (Page 2055) 
RoundButton Object (Page 2052) 
Rectangle Object (Page 2049) 
Polygon Object (Page 2035) 
PieSegment Object (Page 2032) 
OptionGroup Object (Page 2025) 
GraphicObject Object (Page 1975) 
lOField Object (Page 1992) 
EllipseSegment Object (Page 1963) 
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Ellipse Object (Page 1957) 
Circle Object (Page 1928) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 


BackFlashColorOn Property 


Description 
Defines or returns the color of the object background for the flash status "On". LONG write- 
read access. 
Determination of Color Value 
The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 

Example: 


The "RectangleConfiguration()" procedure accesses the properties of the rectangle. In this 
example the color when the flash status is "On" will be set to "Blue": 


Sub RectangleConfiguration () 


"VBA399 
Dim objRectangle As HMIRectangle 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 


With objRectangle 
-BackFlashColorOn = RGB(O, 0, 255) 
End With 

End Suba 


See also 
RoundButton Object (Page 2052) 
StaticText Object (Page 2067) 
Slider object (Page 2062) 
TextList Object (Page 2076) 
RoundRectangle Object (Page 2055) 
Rectangle Object (Page 2049) 
Polygon Object (Page 2035) 
PieSegment Object (Page 2032) 
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OptionGroup Object (Page 2025) 
GraphicObject Object (Page 1975) 
IOField Object (Page 1992) 
EllipseSegment Object (Page 1963) 
Ellipse Object (Page 1957) 

Circle Object (Page 1928) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 
BarGraph Object (Page 1914) 


Background Property 


Description 


TRUE, when the background of the 3D-bar graph object should be visible. BOOLEAN write- 
read access. 


Example: 


The "HMI3DBarGraphConfiguration()" procedure accesses the properties of the 3DBarGraph 
object. In this example the background will be set to "Transparent": 


Sub HMI3DBarGraphConfiguration () 

"VBA400 

Dim obj3DBar As HMI3DBarGraph 

Set obj3DBar = ActiveDocument.HMIObjects.AddHMIObject ("3DBar1", "HMI3DBarGraph") 
With obj3DBar 

-Background = False 

End With 

End Sub 


See also 
3DBarGraph Object (Page 1894) 
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BackPictureAlignment property 


Description 
As the "Display type" attribute, defines the position and scaling for the background image of 
the process picture. 
normal The background picture is centered in the original size. When opening the 
picture in runtime, it remains in the location. 
Stretched (win- The background picture is scaled to the runtime window and process picture 
dow) of the larger of the two windows. In runtime, it is scaled to the size of the 
runtime window and is scaled when you resize the picture. 
Tiled Graphics Designer and process picture are exhibited with the picture in its 
original size. 
Stretched (pic- The background picture is scaled to the configured size of the process pic- 
ture) ture. When opening the picture in runtime, it retains its size. 
BackPictureName property 
Description 


Defines or returns the path and name of the file used as the background image in the process 
picture. 


Files of format EMF, WMF, DB, BMP, GIF, JPG, JPEG and ICO are suitable. 

If no path is specified, the file is searched for in the subdirectory \GraCsS. If you specify a 
different path, a copy is created in the \GraCS directory. 

Path specifications 

The following path specification formats are possible: 

e Absolute: z.B. "C:\Siemens\WinCC\lcons\mylcon.ICO. 


@ Relative: The starting folder for relative path specification is the "GraCS" folder of the current 
project. 


@ <global>: Refers to the installation path for WinCC. The path specification "<global>\lcons 
\mylcon" is the same as the path specification under "Absolute". 


e@ <project>: Refers to the current project directory. 


BarDepth Property 


Description 


Defines or returns the depth of the bar in pixels. 
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Example: 


The "HMI3DBarGraphConfiguration()" procedure accesses the properties of the 3DBarGraph 
object. In this example the bar depth will be set to "40": 


Sub HMI3DBarGraphConfiguration () 

"'VBA401 

Dim obj3DBar As HMI3DBarGraph 

Set obj3DBar = ActiveDocument.HMIObjects.AddHMIObject ("3DBar1", "HMI3DBarGraph") 
With obj3DBar 

-BarDepth = 40 


End With 
End Sub 
See also 
3DBarGraph Object (Page 1894) 
BarHeight Property 
Description 
Defines or returns the height of the bar in pixels. 
Example: 


The "HMI3DBarGraphConfiguration()" procedure accesses the properties of the 3DBarGraph 
object. In this example the bar height will be set to "60": 


Sub HMI3DBarGraphConfiguration () 

"VBA402 

Dim obj3DBar As HMI3DBarGraph 

Set obj3DBar = ActiveDocument.HMIObjects.AddHMIObject ("3DBar1", "HMI3DBarGraph") 
With obj3DBar 

-BarHeight = 60 

End With 

End Sub 


See also 
3DBarGraph Object (Page 1894) 
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BarWidth Property 


Description 


Defines or returns the width of the bar in pixels. 


Example: 


The "HMI3DBarGraphConfiguration()" procedure accesses the properties of the 3DBarGraph 
object. In this example the bar width will be set to "80": 


Sub HMI3DBarGraphConfiguration () 

"VBA403 

Dim obj3DBar As HMI3DBarGraph 

Set obj3DBar = ActiveDocument.HMIObjects.AddHMIObject ("3DBar1", "HMI3DBarGraph") 
With obj3DBar 

-BarWidth = 80 

End With 

End Sub 


See also 
3DBarGraph Object (Page 1894) 


BasePicReferenced Property 


Description 


TRUE, when the picture assigned in the object status display should be saved. Otherwise, 
only the associated object reference is saved. BOOLEAN write-read access. 


Example: 


The "StatusDisplayConfiguration()" procedure accesses the properties of the Status Display. 
In this example the picture assigned in the Status Display object is to be saved. 


Sub StatusDisplayConfiguration () 

"VBA404 

Dim objStatDisp As HMIStatusDisplay 

Set objStatDisp = ActiveDocument.HMIObjects.AddHMIObject ("Statusdisplayl", 
"HMIStatusDisplay") 

With objStatDisp 

.-BasePicReferenced = Tru 

End With 

End Sub 
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See also 
StatusDisplay Object (Page 2070) 


BasePicTransColor Property 


Description 
Defines or returns which color of the assigned bitmap object (.bmp, .dib) should be set to 
"transparent". LONG write-read access. 
The color is only set to "Transparent" if the value of the "BasePicUseTransColor" property is 
"True". 
Determination of Color Value 
The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 

Example: 


The "StatusDisplayConfiguration()" procedure accesses the properties of the Status Display. 
In this example the color "Yellow" will be set to "Transparent". 


Sub StatusDisplayConfiguration () 

"VBA405 

Dim objStatDisp As HMIStatusDisplay 

Set objStatDisp = ActiveDocument.HMIObjects.AddHMIObject ("Statusdisplayl", 
"HMIStatusDisplay") 

With objStatDisp 

-BasePicTransColor = RGB(255, 255, 0) 

-BasePicUseTransColor = True 

End With 

End Sub 


See also 
BasePicUseTransColor Property (Page 2145) 
StatusDisplay Object (Page 2070) 


BasePicture Property 


Description 


Defines or returns the basic picture for the Status Display object. 
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The picture (*.BMP or *.DIB) must be located in the "GraCS" directory of the current project 
so that it can be integrated. 


In this context, the "BasePicReferenced" property defines whether the basic picture should be 
saved together with the object status display or referenced. 


Example: 


The "StatusDisplayConfiguration()" procedure accesses the properties of the Status Display. 
In this example the picture "Testpicture.BMP" will be used as the basic picture: 


Sub StatusDisplayConfiguration () 

"VBA406 

Dim objStatDisp As HMIStatusDisplay 

Set objStatDisp = ActiveDocument.HMIObjects.AddHMIObject ("Statusdisplayl", 
"HMIStatusDisplay") 

With objStatDisp 

' 


'To use this example copy a Bitmap-Graphic 

‘to the "GraCS"-Folder of the actual project. 

"Replace the picturename "Testpicture.BMP" with the name of 
"the picture you copied 

-BasePicture = "Testpicture.BMP" 

End With 

End Sub 


See also 
BasePicReferenced Property (Page 2143) 
StatusDisplay Object (Page 2070) 


BasePicture property 


Description 


Specifies which picture is to be displayed for the currently selected status. Pictures with the 
following formats can be inserted: EMF, WMF, BMP, GIF, JPG. 


If no picture that you want to display is defined for a status, the symbol for the status display 
is shown as a placeholder. 


BasePicUseTransColor Property 


Description 


TRUE, when the configured color ("BasePicTransColor" property) of the bitmap objects should 
be set to "transparent". BOOLEAN write-read access. 
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Example: 


The "StatusDisplayConfiguration()" procedure accesses the properties of the Status Display. 
In this example the color "Yellow" will be set to "Transparent": 


Sub StatusDisplayConfiguration () 

"VBA407 

Dim objStatDisp As HMIStatusDisplay 

Set objStatDisp = ActiveDocument.HMIObjects.AddHMIObject ("Statusdisplayl", 
"HMIStatusDisplay") 

With objStatDisp 

-BasePicTransColor = RGB(255, 255, 0) 

-BasePicUseTransColor = True 

End With 

End Sub 


See also 
BasePicTransColor Property (Page 2144) 
StatusDisplay Object (Page 2070) 


BaseX Property 

Description 
Defines or returns for the 3DBarGraph object the horizontal distance in pixels between the 
right-hand border of the bar and the left-hand border of the object field. 

Example: 


The "HMI3DBarGraphConfiguration()" procedure accesses the properties of the 3DBarGraph 
object. In this example the horizontal distance will be set to "80". 


Sub HMI3DBarGraphConfiguration () 

"'VBA408 

Dim obj3DBar As HMI3DBarGraph 

Set obj3DBar = ActiveDocument.HMIObjects.AddHMIObject ("3DBar1", "HMI3DBarGraph") 
With obj3DBar 

-BaseX = 80 

End With 

End Sub 


See also 
3DBarGraph Object (Page 1894) 
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BaseY Property 


Description 


Defines or returns for the 3DBarGraph object the vertical distance in pixels between the lower 
border of the bar and the upper border of the object field. 


Example: 


The "HMI3DBarGraphConfiguration()" procedure accesses the properties of the 3DBarGraph 
object. In this example the vertical distance will be set to "100". 


Sub HMI3DBarGraphConfiguration () 

"VBA409 

Dim obj3DBar As HMI3DBarGraph 

Set obj3DBar = ActiveDocument.HMIObjects.AddHMIObject ("3DBar1", "HMI3DBarGraph") 
With obj3DBar 

-BaseY = 100 


End With 
End Sub 
See also 
3DBarGraph Object (Page 1894) 
BinaryResultInfo Property 
Description 
Returns the BinaryResultInfo object. 
Example: 
An example showing how to use the BinaryResultInfo property can be found in this 
documentation under the heading "BinaryResultInfo Object". 
See also 


BinaryResultInfo Object (Page 1918) 
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BitNotSetValue Property 


Description 


Defines or returns the value for the dynamic property if the specified bit of a configured tag is 
not set. 


To define which bit must be set in order to trigger a change of value, use the BitNumber 
property. 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog, a tag name will be assigned, the bit to be set will be defined and the associated property 
values will be assigned to the "set"/"not set" states: 


Sub AddDynamicDialogToCircleRadiusTypeBit () 
"'VBA410 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle B", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
"'NewDynamicl'") 


With objDynDialog 

-ResultType = hmiResultTypeBit 
.Trigger.VariableTriggers(1).CycleType = hmiVariableCycleType 5s 
-BitResultInfo.BitNumber = 1 
-BitResultInfo.BitSetValue = 40 


-BitResultInfo.BitNotSetValue 80 

End With 

End Sub 

See also 
BitNumber Property (Page 2148) 
BitResultInfo Object (Page 1919) 

BitNumber Property 

Description 


Defines or returns the bit whose status must change in order to trigger a change of value. The 
tag used must be of the type BYTE, WORD or DWORD. 
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Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog, a tag name will be assigned, the bit to be set will be defined and the associated property 
values will be assigned to the "set"/"not set" states: 


Sub AddDynamicDialogToCircleRadiusTypeBit () 
'VBA411 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle B", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 

-ResultType = hmiResultTypeBit 
-BitResultInfo.BitNumber = 1 
-BitResultInfo.BitSetValue = 40 
-BitResultInfo.BitNotSetValue = 80 
End With 

End Sub 


See also 
BitResultInfo Object (Page 1919) 
VBA Reference (Page 1745) 


BitPosition0..3 property 


Description 
Specifies the bit position of the selected tag for which the respective bit (0 to 3) of the status 
value is used. The content is only evaluated when a tag is selected for the respective property 
"BitSelect0..3". The tags are specified using "Process" and "Process1..3". 
You can enter a value from "0" to "31". Each value can only be assigned once. 
BitResultInfo Property 
Description 
Returns the BitResultInfo object. 
Example: 


An example showing how to use the BitResultInfo property can be found in this documentation 
under the heading "BitResultInfo Object". 
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See also 
BitResultInfo Object (Page 1919) 


BitSelect0..3 property 


Description 


Specifies the status tag for which the respective (first to fourth) bit of the status value is 
specified. The tags are specified using the properties "Process" and "Process1..3". 


The respective bit of the status value is not evaluated. No status tag is used. 


Status tag "Process" is used for the respective bit of the status value. 


Status tag "Process" is used for the respective bit of the status value. 


Status tag "Process2" is used for the respective bit of the status value. 


BRLwW]M]—->/oO 


Status tag "Process3" is used for the respective bit of the status value. 


BitSetValue Property 


Description 


Defines or returns the value for the dynamic property if the specified bit of a configured tag is 
set. 


To define which bit must be set in order to trigger a change of value, use the BitNumber 
property. 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog, a tag name will be assigned, the bit to be set will be defined and the associated property 
values will be assigned to the "set"/"not set" states: 


Sub AddDynamicDialogToCircleRadiusTypeBit () 
"VBA412 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle B", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 

-ResultType = hmiResultTypeBit 
-BitResultInfo.BitNumber = 1 
-BitResultInfo.BitSetValue = 40 
-BitResultInfo.BitNotSetValue = 
End With 

End Sub 


80 
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See also 
BitNumber Property (Page 2148) 
BitResultInfo Object (Page 1919) 
Bold Property 
Description 
TRUE if the font attribute "Bold" is set for the language-dependent text in the object. BOOLEAN 
write-read access. 
Example: 


Note 


For this example to work, you must already have configured in the languages concerned. 


The following example sets the font attributes of a button for French and English: 


Sub ExampleForLanguageFonts () 

"VBA413 

Dim colLangFonts As HMILanguageFonts 

Dim objButton As HMIButton 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMTButton") 
objButton.Text = "Displaytext" 

Set colLangFonts = objButton.LDFonts 

"Set french fontproperties: 


With colLangFonts.ItemByLCID (1036) 
-Family = "Courier New" 
-Bold = True 


-Italic = False 
-Underlined = Tru 
-Size = 12 

End With 
"Set english fontproperties: 

With colLangFonts.ItemByLCID (1033) 
-Family = "Times New Roman" 

-Bold = False 

-Italic = True 

-Underlined = Fals 

Size = 14 

End With 

End Sub 
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See also 
Underlined Property (Page 2460) 
Size Property (Page 2419) 
Parent Property (Page 2359) 
LanguagelD Property (Page 2289) 
Italic Property (Page 2282) 
Family Property (Page 2229) 
Application Property (Page 2121) 
LanguageFont Object (Page 1996) 


BorderBackColor Property 


Description 
Defines or returns the background color of the line for the object. LONG write-read access. 


The background color is only visible if the BorderStyle property is set >0. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


Example: 


The "RectangleConfiguration()" procedure accesses the properties of the rectangle. In this 
example the background color for the line will be set to "Yellow": 


Sub RectangleConfiguration () 


"VBA415 
Dim objRectangle As HMIRectangle 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 


With objRectangle 

-BorderBackColor = RGB(255, 255, 0) 
End With 

End Sub 


See also 
PieSegment Object (Page 2032) 
BorderStyle Property (Page 2160) 
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TextList Object (Page 2076) 
StatusDisplay Object (Page 2070) 
StaticText Object (Page 2067) 
Slider object (Page 2062) 
RoundRectangle Object (Page 2055) 
RoundButton Object (Page 2052) 
Rectangle Object (Page 2049) 
PolyLine Object (Page 2038) 
OptionGroup Object (Page 2025) 
Line Object (Page 2004) 

IOField Object (Page 1992) 
GraphicObject Object (Page 1975) 
EllipseArc Object (Page 1960) 
EllipseSegment Object (Page 1963) 
Ellipse Object (Page 1957) 
CircularArc Object (Page 1931) 
Circle Object (Page 1928) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 
BarGraph Object (Page 1914) 


BorderColor Property 


3.6 VBA Reference 


Defines or returns the line color for the object. LONG write-read access. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 


represented as follows: RGB(255, 0, 0) 
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Example: 


Sub RectangleCo 
"VBA416 

Dim objRectangl 
Set objRectangl 


The "RectangleConfiguration()" procedure accesses the properties of the rectangle. In this 


example the line color will be set to "Blue": 


nfiguration () 


e As HMIRectangle 


= ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 


With objRectangle 


-BorderColor = 
End With 
End Sub 


See also 


2154 


RGB(0, 0, 255) 


GraphicObject Object (Page 1975) 
TextList Object (Page 2076) 
StatusDisplay Object (Page 2070) 
StaticText Object (Page 2067) 
Slider object (Page 2062) 
RoundRectangle Object (Page 2055) 
RoundButton Object (Page 2052) 
Rectangle Object (Page 2049) 
PolyLine Object (Page 2038) 
PieSegment Object (Page 2032) 
OptionGroup Object (Page 2025) 
Line Object (Page 2004) 

lOField Object (Page 1992) 
EllipseArc Object (Page 1960) 
EllipseSegment Object (Page 1963) 
Ellipse Object (Page 1957) 
CircularArc Object (Page 1931) 
Circle Object (Page 1928) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 
BarGraph Object (Page 1914) 
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BorderColorBottom Property 


Description 
Defines or returns the color for the bottom right-hand part of the 3D-border. LONG write-read 
access. 
Determination of Color Value 
The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 

Example: 


The "ButtonConfiguration()" procedure accesses the properties of the button. In this example 
the 3D-border color will be defined: 


Sub ButtonConfiguration() 


"VBA417 
Dim objButton As HMIButton 
Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Button1l", "“HMIButton") 


With objButton 

-BorderColorBottom = RGB(255, 0, 0) 
-BorderColorTop = RGB(0, 0, 255) 
End With 

End Sub 


See also 
RoundButton Object (Page 2052) 
Button Object (Page 1921) 


BorderColorTop Property 


Description 


Defines or returns the color for the top left-hand part of the 3D-border. LONG write-read access. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
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Example: 


The "ButtonConfiguration()" procedure accesses the properties of the button. In this example 
the 3D-border color will be defined: 


Sub ButtonConfiguration() 


"'VBA418 


Dim objButton As HMIButton 
Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Buttonl", “HMIButton") 


With objButton 


-BorderColorBottom = RGB(255, 0, 0) 


-BorderColorTop 


End With 
End Sub 


See also 


= RGB(O, 0, 255) 


RoundButton Object (Page 2052) 
Button Object (Page 1921) 


BorderEndStyle Property 


Description 


2156 


Defines or returns the line end style of the object. LONG read-write access. 


Determination of Line End Style 


Determine the line end type with the aid of a five-character hexadecimal value which you then 
convert into its equivalent decimal value. 
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To determine the line ends for the object, go to the "Line End Style" window and proceed as 
follows: 


e Left column: Configures the start of the line. Value range (from the top down) 0 to 6. The 
start of the line corresponds to the first character in the hexadecimal value. In the 
configuration shown, the value of the first character is "3". 


e@ Right Column: Configures the end of the line. Value range (from the top down) 0 to 6. The 
line end corresponds to the fifth character in the hexadecimal value. In the configuration 
shown, the value of the fifth character is "6". 


This gives a hexadecimal value of "60003". This corresponds to a decimal value of "393219", 
which you then assign to the BorderEndStyle property. 


The "LineConfiguration()" procedure accesses the properties of the line. In this example the 
type of line end will be set to the configuration illustrated above: 


Sub LineConfiguration() 


"VBA419 


Dim objLine As HMILine 


Set objLin 


With objLine 


-BorderEndStyle 


End With 
End Sub 


See also 


= ActiveDocument.HMIObjects.AddHMIObject ("Linel", "HMILine") 


= 393219 


PolyLine Object (Page 2038) 
Line Object (Page 2004) 


BorderFlashColorOff Property 


Description 


Defines or returns the color of the object lines for the flashing status "Off". LONG write-read 
access. 
Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
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Example: 


The "RectangleConfiguration()" procedure accesses the properties of the rectangle. In this 
example the color when the flash status is "Off" will be set to "Black": 


Sub RectangleConfiguration () 


"VBA420 


Dim objRectangle As HMIRectangle 
= ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 


Set objRectangl 


With objRectangle 


-BorderFlashCol 
End With 
End Sub 


See also 


2158 


orOff = RGB(O, O, 0) 
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BorderFlashColorOn Property 


Description 
Defines or returns the color of the object lines for the flashing status "On". LONG write-read 
access. 
Determination of Color Value 
The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 

Example: 


The "RectangleConfiguration()" procedure accesses the properties of the rectangle. In this 
example the color when the flash status is "On" will be set to "Red": 


Sub RectangleConfiguration () 


'VBA421 
Dim objRectangle As HMIRectangle 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 


With objRectangle 
-BorderFlashColorOn = RGB(255, 0, O) 
End With 

End Sub 


See also 
StaticText Object (Page 2067) 
StatusDisplay Object (Page 2070) 
Slider object (Page 2062) 
TextList Object (Page 2076) 
RoundRectangle Object (Page 2055) 
RoundButton Object (Page 2052) 
Rectangle Object (Page 2049) 
PolyLine Object (Page 2038) 
Polygon Object (Page 2035) 
PieSegment Object (Page 2032) 
OptionGroup Object (Page 2025) 
Line Object (Page 2004) 
GraphicObject Object (Page 1975) 
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lOField Object (Page 1992) 
EllipseSegment Object (Page 1963) 
EllipseArc Object (Page 1960) 
Ellipse Object (Page 1957) 
CircularArc Object (Page 1931) 
Circle Object (Page 1928) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 


BorderStyle Property 


Description 


Defines or returns the line style for the object. Value range from 0 to 4: 


Line style 


Assigned Value 


BR) oO!nmo] = 


Example: 


The "RectangleConfiguration()" procedure accesses the properties of the rectangle. In this 


example the line style will be set to "1": 


Sub RectangleConfiguration () 
"VBA422 
Dim objRectangle As HMIRectangle 


Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 


With objRectangle 
-BorderStyle = 1 


End With 
End Sub 
See also 
lOField Object (Page 1992) 
StatusDisplay Object (Page 2070) 
StaticText Object (Page 2067) 
2160 
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Slider object (Page 2062) 
RoundRectangle Object (Page 2055) 
RoundButton Object (Page 2052) 
Rectangle Object (Page 2049) 
Polygon Object (Page 2035) 
PolyLine Object (Page 2038) 
TextList Object (Page 2076) 
PieSegment Object (Page 2032) 
OptionGroup Object (Page 2025) 
Line Object (Page 2004) 
GraphicObject Object (Page 1975) 
EllipseSegment Object (Page 1963) 
EllipseArc Object (Page 1960) 
Ellipse Object (Page 1957) 
CircularArc Object (Page 1931) 
Circle Object (Page 1928) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 
BarGraph Object (Page 1914) 
3DBarGraph Object (Page 1894) 


BorderWidth Property 


Description 


Example: 


Defines or returns the line weight (in pixels) for the object. 


3.6 VBA Reference 


in the following example the line weight of a newly added circle will be set to "2". 


Sub CircleConfiguration () 


"VBA423 


Dim objCircle As IHMICircle 


Set objCircl 


With objCircle 
-BorderWidth = 
End With 
End Sub 


2 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 


= ActiveDocument.HMIObjects.AddHMIObject ("Circlel", "HMICircle") 
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See also 
IOField Object (Page 1992) 
StatusDisplay Object (Page 2070) 
StaticText Object (Page 2067) 
Slider object (Page 2062) 
TextList Object (Page 2076) 
RoundRectangle Object (Page 2055) 
RoundButton Object (Page 2052) 
Rectangle Object (Page 2049) 
PolyLine Object (Page 2038) 
Polygon Object (Page 2035) 
PieSegment Object (Page 2032) 
OptionGroup Object (Page 2025) 
Line Object (Page 2004) 
GraphicObject Object (Page 1975) 
EllipseSegment Object (Page 1963) 
EllipseArc Object (Page 1960) 
Ellipse Object (Page 1957) 
CircularArc Object (Page 1931) 
Circle Object (Page 1928) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 


BottomConnectedObjectName Property 


Description 
Returns the name of the starting object to which the connector is Read only access. 
Example: 
An example showing how to use the BottomConnectedObjectName property can be found in 
this documentation under the heading "ObjConnection Object". 
See also 


ObjConnection object (Page 2019) 
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BottomConnectedConnectionPointIndex Property 


Description 
Returns the connection point on the object to which the connector is connected. 
Connection Point Assigned Value 
Up 0 
Right 1 
Down 2 
Left 3 
Example: 
An example showing how to use the BottomConnectedObjectName property can be found in 
this documentation under the heading "ObjConnection Object". 
See also 


ObjConnection object (Page 2019) 


BoxAlignment Property 


Description 
TRUE, when the fields are arranged aligned to the right. BOOLEAN write-read access. 
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Example: 


The "CreateOptionGroup()" procedure creates the OptionGroup object with four option 
buttons. Each option button is assigned the default name "myCustomText<Nummer>": 


Sub CreateOptionGroup () 

"VBA424 

Dim objRadioBox As HMIOptionGroup 
Dim iCounter As Integer 


Set objRadioBox = ActiveDocument.HMIObjects.AddHMIObject ("RadioBox 1", "HMIOptionGroup") 


iCounter = 1 
With objRadioBox 
-Height = 100 
-Width = 180 


Defines or returns the number of fields. Value range from 1 to 32. 


-BoxCount = 4 
-BoxAlignment = False 
For iCounter = 1 To .BoxCount 
-index = iCounter 
-Text = "CustomText" & .index 
ext iCounter 
End With 
End Sub 
See also 
BoxCount Property (Page 2164) 
OptionGroup Object (Page 2025) 
CheckBox Object (Page 1924) 
BoxCount Property 
Description 
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Example: 


The "CreateOptionGroup()" procedure creates the OptionGroup object with four option 
buttons. Each option button is assigned the default name "myCustomText<Nummer>": 


Sub CreateOptionGroup () 

"VBA425 

Dim objRadioBox As HMIOptionGroup 
Dim iCounter As Integer 

Set objRadioBox = ActiveDocument.HMIObjects.AddHMIObject ("RadioBox 1", "HMIOptionGroup") 
iCounter = 1 

With objRadioBox 

-Height = 100 

-Width = 180 

-BoxCount = 4 

-BoxAlignment = True 

For iCounter = 1 To .BoxCount 
-index = iCounter 

-Text = "CustomText" & .index 

ext iCounter 

End With 

End Sub 


See also 
BoxAlignment Property (Page 2163) 
OptionGroup Object (Page 2025) 
CheckBox Object (Page 1924) 


BoxType Property 


Description 


Defines or returns the field type. Value range from 0 to 2. 


Field type Assigned Value 
Edition 0 
Input 1 
I/O field 2 
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Example: 


The "lOFieldConfiguration()" procedure accesses the properties of the I/O field. In this example 
the field type is configured as "Input": 


Sub IOFieldConfiguration () 

"VBA426 

Dim objJIOField As HMIIOField 

Set obj1I0OField = ActiveDocument.HMIObjects.AddHMIObject ("IOField1l", "HMIIOField") 
With obj1IOField 

-BoxType = 1 

End With 

End Sub 


See also 
lOField Object (Page 1992) 


Button1..8MessageClasses 


Description 


Defines one or more message events in the group display for representing the respective 
command button. This is done by entering the numbers of the bits in the collective value. 


If you want to assign several message events, delimit the numbers with a comma. The order 
of assignment defines the priority. If there is more than one selected event for one button, the 
event that has been entered first is displayed. 


The same event can be visualized simultaneously in several buttons. 
Button1..8Width property 
Description 


Defines or returns for the "Group Display" object the width of the respective button in pixels. 


When the "SameSize" property is set to "TRUE", all buttons are set to the same width. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
2166 System Manual, 02/2016, ASE37536061-AA 


VBA for Automated Configuration 
3.6 VBA Reference 


Example 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the width of button "1" is set to "50": 


Sub GroupDisplayConfiguration() 

"VBA427 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMTGroupDisplay") 

With objGroupDisplay 

-ButtonlWidth = 50 


End With 
End Sub 
See also 
SameSize Property (Page 2403) 
GroupDisplay Object (Page 1980) 
ButtonColor Property 
Description 
Defines or returns the color of the slider for the Slider object. LONG write-read access. 
Determination of Color Value 
The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
Example: 


The "SliderConfiguration()" procedure accesses the properties of the slider. In this example 
the color of the slider will be set to "Yellow". 


Sub SliderConfiguration () 

'VBA431 

Dim objSlider As HMISlider 

Set objSlider = ActiveDocument.HMIObjects.AddHMIObject ("SliderObject1i", "HMISlider") 
With objSlider 

-ButtonColor = RGB(255, 255, 0) 

End With 

End Sub 
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See also 
Slider object (Page 2062) 


Cc 


Caption Property 


TRUE, when the application or picture window has a title bar in Runtime. BOOLEAN write-read 


Description 
access. 
The Caption property must be set to "True" if the intention is that the application window or 
picture window shall have Maximize and Close buttons. 

Example: 


The "ApplicationWindowConfig" procedure accesses the properties of the application window. 


In this example the application window will 


Sub ApplicationWindowConfig() 
"VBA432 
Dim objAppWindow As HMIApplicationWindow 


Set objAppWindow = ActiveDocument.HMIObjects.AddHMIObject ("AppWindow", 


"HMTApplicationWindow") 
With objAppWindow 
-Caption = True 
-CloseButton = False 
-Height = 200 


-Left = 10 

-MaximizeButton = True 

-Moveable = False 

-OnTop = True 

-Sizeable = True 

-Top = 20 

-Visible = True 

-Width = 250 

-WindowBorder = True 

End With 

End Sub 

See also 
PictureWindow Object (Page 2029) 
ApplicationWindow Object (Page 1911) 
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CaptionText Property 


Description 


Defines or returns the window title that will be displayed for the PictureWindow object in 
Runtime. 


The Caption property must be set to TRUE." 


Example: 


The "PictureWindowConfig" procedure accesses the properties of the picture window. In this 
example the picture window will 


Sub PictureWindowConfig() 

'VBA433 

Dim objPicWindow As HMIPictureWindow 

Set objPicWindow = ActiveDocument.HMIObjects.AddHMIObject ("PicWindowl", "HMIPictureWindow") 
With objPicWindow 

-AdaptPicture = False 

-AdaptSize = False 

-Caption = True 


-CaptionText = "Picturewindow in runtime" 
-OffsetLeft = 5 

-OffsetTop = 10 

"Replace the picturename "Test.PDL" with the name of 
‘an existing document from your "GraCS"-Folder of your active project 
.PictureName = "Test.PDL" 

-ScrollBars = True 

.ServerPrefix = ™" 

-TagPrefix = "Struct." 

-UpdateCycle = 5 

-Zoom = 100 

End With 

End Sub 


See also 
PictureWindow Object (Page 2029) 


CBackColorOff..ColorOn property 


Description 


Specifies for the selected message type and the state "Came In" which color the background 
of the value to be displayed assumes for flashing status "Off" (CBackColorOff) or "On" 
(CBackColorOn). 
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Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0). 


CBackFlash property 


Description 


Specifies for the selected message type and status "Came In" whether the background of the 
value to be displayed flashes when a message is received. 


CheckAlarmHigh Property 


Description 
TRUE if the "Alarm High" limit value is being monitored for the BarGraph object. BOOLEAN 
write-read access. 
The limit value, the display on reaching the limit value and the type of evaluation are defined 
via the properties AlarmHigh, ColorAlarmHigh and TypeAlarmHigh. 

Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the high limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "50". 


Sub BarGraphLimitConfiguration () 
'VBA434 

Dim objBarGraph As HMIBarGraph 
Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 
.TypeAlarmHigh = False 

"Activate monitoring 
-CheckAlarmHigh = True 

"Set barcolor to "yellow" 
-ColorAlarmHigh = RGB(255, 255, 0) 
"Set upper limit to "50" 
-AlarmHigh = 50 

End With 

End Sub 
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See also 
TypeAlarmHigh Property (Page 2451) 
ColorAlarmHigh Property (Page 2182) 
AlarmHigh Property (Page 2114) 
BarGraph Object (Page 1914) 


CheckAlarmLow Property 


Description 


TRUE if the "Alarm Low" limit value is being monitored for the BarGraph object. BOOLEAN 
write-read access. 


The limit value, the display on reaching the limit value and the type of evaluation are defined 
via the properties AlarmLow, ColorAlarmLow and TypeAlarmLow. 


Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the low limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "10". 


Sub BarGraphLimitConfiguration () 
"VBA435 

Dim objBarGraph As HMIBarGraph 
Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 
.-TypeAlarmLow = False 

"Activate monitoring 
-CheckAlarmLow = True 

"Set barcolor to "yellow" 
-ColorAlarmLow = RGB(255, 255, 0) 
"Set lower limit to "10" 
-AlarmLow = 10 

End With 

End Sub 


See also 
ColorAlarmLow Property (Page 2183) 
TypeAlarmLow Property (Page 2452) 
AlarmLow Property (Page 2115) 
BarGraph Object (Page 1914) 
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Checked Property 


Description 


TRUE if a check mark is to appear in front of the user-defined menu entry. BOOLEAN write- 
read access. 


Example: 


The "CreateMenultem()" procedure creates the "Delete Objects" menu and adds two menu 
entries ("Delete Rectangles" and "Delete Circles"): The first menu entry is also marked with a 
tick: 


Sub CreateMenulItem () 

"VBA436 

Dim objMenu As HMIMenu 

Dim objMenuItem As HMIMenuItem 
' 


"Add new menu "Delete objects" to menubar: 
Set objMenu = ActiveDocument.CustomMenus.InsertMenu(1, "DeleteObjects", "Delete objects") 
' 


‘Add two menuitems to the new menu 

Set objMenuItem = objMenu.Menultems.InsertMenuItem(1, "DeleteAllRectangles", "Delet 
Rectangles") 

Set objMenulItem = objMenu.MenuItems.InsertMenuItem(2, "DeleteAllCircles", "Delete Circles") 
With objMenu.MenuItems 

-Item("DeleteAllRectangles") .Checked = Tru 

End With 
End Sub 


See also 
Menultems Property (Page 2337) 
Configuring Menus and Toolbars (Page 1626) 


CheckLimitHigh4 Property 


Description 


TRUE if the "Reserve 4" high limit value of the bar graph object is to be monitored. BOOLEAN 
write-read access. 


The limit value, the display on reaching the limit value and the type of evaluation are defined 
via the properties LimitHigh4, ColorLimitHigh4 and TypeLimitHigh4. 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the high limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "70". 


Sub BarGraphLimitConfiguration () 
"VBA437 

Dim objBarGraph As HMIBarGraph 
Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 
.TypeLimitHigh4 = False 

"Activate monitoring 
-CheckLimitHigh4 = True 

"set barcolor to "red" 
-ColorLimitHigh4 = RGB(255, 0, 0) 
"Set upper limit to "70" 
-LimitHigh4 = 70 


End With 
End Sub 
See also 
TypeLimitHigh4 Property (Page 2453) 
LimitHigh4 Property (Page 2307) 
ColorLimitHigh4 Property (Page 2186) 
BarGraph Object (Page 1914) 
CheckLimitHigh5 Property 
Description 


TRUE if the "Reserve 5" high limit value of the bar graph object is to be monitored. BOOLEAN 
write-read access. 


The limit value, the display on reaching the limit value and the type of evaluation are defined 
via the properties LimitHigh5, ColorLimitHigh5 and TypeLimitHigh5. 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the high limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "80". 


Sub BarGraphLimitConfiguration () 
"VBA438 

Dim objBarGraph As HMIBarGraph 
Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 
.TypeLimitHigh5 = False 
"Activate monitoring 
-CheckLimitHigh5 = True 

"set barcolor to "black" 
-ColorLimitHigh5 = RGB(0, 0, 0) 
"Set upper limit to "80" 
-LimitHigh5 = 80 

End With 

End Sub 


See also 
ColorLimitHighS Property (Page 2186) 
TypeLimitHigh5 Property (Page 2453) 
LimitHigh4 Property (Page 2307) 
BarGraph Object (Page 1914) 


CheckLimitLow4 Property 


Description 
TRUE if the "Reserve 4" low limit value of the bar graph object is to be monitored. BOOLEAN 
write-read access. 
The limit value, the display on reaching the limit value and the type of evaluation are defined 
via the properties LimitLow4, ColorLimitLow4 and TypeLimitLow4. 
WinCC: Scripting (VBS, ANSI-C, VBA) 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the low limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "5". 


Sub BarGraphLimitConfiguration () 
"VBA439 

Dim objBarGraph As HMIBarGraph 
Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 
.TypeLimitLow4 = False 

"Activate monitoring 
-CheckLimitLow4 = True 

"Set barcolor to "green" 
-ColorLimitLow4 = RGB(0, 255, 0) 
"set lower limit to "5" 
-LimitLow4 = 5 

End With 

End Sub 


See also 
TypeLimitLow4 Property (Page 2454) 
LimitLow4 Property (Page 2308) 
ColorLimitLow4 Property (Page 2187) 
BarGraph Object (Page 1914) 


CheckLimitLow5 Property 


Description 


TRUE if the "Reserve 5" low limit value of the bar graph object is to be monitored. BOOLEAN 
write-read access. 


The limit value, the display on reaching the limit value and the type of evaluation are defined 
via the properties LimitLow5, ColorLimitLow5 and TypeLimitLow5. 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the low limit value 


for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "0". 


Sub BarGraphLimitConfiguration () 
"VBA440 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 
.TypeLimitLow5 = False 

"Activate monitoring 

-CheckLimitLow5 = True 

"Set barcolor to "white" 
-ColorLimitLow5 = RGB(255, 255, 255) 
"set lower limit to "0" 

-LimitLow5 = 0 

End With 

End Sub 


See also 
TypeLimitLow5 Property (Page 2455) 
LimitLow5 Property (Page 2309) 
ColorLimitLow5 Property (Page 2188) 
BarGraph Object (Page 1914) 


CheckToleranceHigh Property 


Description 
TRUE if the "Tolerance High" limit value is being monitored for the BarGraph object. BOOLEAN 
write-read access. 
The limit value, the display on reaching the limit value and the type of evaluation are defined 
via the properties ToleranceHigh, ColorToleranceHigh and TypeToleranceHigh. 
WinCC: Scripting (VBS, ANSI-C, VBA) 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the high limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "45". 


Sub BarGraphLimitConfiguration () 
"VBA441 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 
.TypeToleranceHigh = Fals 

"Activate monitoring 
-CheckToleranceHigh = Tru 

"Set barcolor to "yellow" 
-ColorToleranceHigh = RGB(255, 255, 0) 
"Set upper limit to "45" 
-ToleranceHigh = 45 

End With 

End Sub 


See also 
TypeToleranceHigh Property (Page 2456) 
ToleranceHigh Property (Page 2442) 
ColorToleranceHigh Property (Page 2189) 
BarGraph Object (Page 1914) 


CheckToleranceLow Property 


Description 


TRUE if the "Tolerance Low" limit value is being monitored for the BarGraph object. BOOLEAN 
write-read access. 


The limit value, the display on reaching the limit value and the type of evaluation are defined 
via the properties ToleranceLow, ColorToleranceLow and TypeToleranceLow. 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the low limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "15". 


Sub BarGraphLimitConfiguration () 
"VBA442 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 
.-TypeToleranceLow = Fals 

"Activate monitoring 
-CheckToleranceLow = Tru 

"Set barcolor to "yellow" 
-ColorToleranceLow = RGB(255, 255, 0) 
"Set lower limit to "15" 
-ToleranceLow = 15 

End With 

End Sub 


See also 
BarGraph Object (Page 1914) 
TypeToleranceLow Property (Page 2457) 
ToleranceLow Property (Page 2442) 
ColorToleranceLow Property (Page 2190) 


CheckWarningHigh Property 


Description 


TRUE if the "Warning High" limit value is being monitored for the BarGraph object. BOOLEAN 
write-read access. 


The limit value, the display on reaching the limit value and the type of evaluation are defined 
via the properties WarningHigh, ColorWarningHigh and TypeWarningHigh. 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the high limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "75". 


Sub BarGraphLimitConfiguration () 
"VBA443 

Dim objBarGraph As HMIBarGraph 
Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 
.TypeWarningHigh = False 

"Activate monitoring 
.CheckWarningHigh = True 

"Set barcolor to "red" 
-ColorWarningHigh = RGB(255, 0, 0) 
"Set upper limit to "75" 
-WarningHigh = 75 


End With 
End Sub 
See also 
WarningHigh Property (Page 2552) 
TypeWarningHigh Property (Page 2458) 
ColorWarningHigh Property (Page 2192) 
BarGraph Object (Page 1914) 
CheckWarningLow Property 
Description 


TRUE if the "Warning Low" limit value is being monitored for the BarGraph object. BOOLEAN 
write-read access. 


The limit value, the display on reaching the limit value and the type of evaluation are defined 
via the properties WarningLow, ColorWarningLow and TypeWarningLow. 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the low limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "12". 


Sub BarGraphLimitConfiguration () 

"VBA444 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 

.TypeWarningLow = False 

"Activate monitoring 

-CheckWarningLow = True 


"Set barcolor to "magenta" 
-ColorWarningLow = RGB(255, 0, 255) 
"Set lower limit to "12" 
-WarningLow = 12 

End With 

End Sub 


See also 
WarningLow Property (Page 2553) 
TypeWarningLow Property (Page 2459) 
ColorWarningLow Property (Page 2193) 
BarGraph Object (Page 1914) 


ClearOnError Property 


Description 


TRUE if the entry in the I/O field is automatically deleted when the input is incorrect. BOOLEAN 
write-read access. 
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Example: 


The "IOFieldConfiguration()" procedure accesses the properties of the I/O field. In this example 
the I/O field is to be cleared when the input is incorrect: 


Sub IOFieldConfiguration () 

"VBA445 

Dim objJIOField As HMIIOField 

Set obj1I0OField = ActiveDocument.HMIObjects.AddHMIObject ("IOField1l", "HMIIOField") 
With obj1IOField 

-ClearOnError = True 

End With 

End Sub 


See also 
|OField Object (Page 1992) 


ClearOnNew Property 


Description 


TRUE if the entry in the I/O field is deleted as soon as the I/O field gets the focus. BOOLEAN 
write-read access. 


Example: 


The "lOFieldConfiguration()" procedure accesses the properties of the I/O field. In this example 
the entry in the I/O field is deleted as soon as the field gets the focus: 


Sub I0FieldConfiguration () 

"VBA446 

Dim objJIOField As HMIIOField 

Set obj1IOField = ActiveDocument.HMIObjects.AddHMIObject ("IOField1i", "HMIIOField") 
With obj1IOField 

-ClearOnNew = Tru 

End With 

End Sub 


See also 
|OField Object (Page 1992) 
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CloseButton Property 


Description 


TRUE if the ApplicationWindow and PictureWindow objects possess a "Close" button in 
Runtime. BOOLEAN write-read access. 


Example: 


The "ApplicationWindowConfig" procedure accesses the properties of the application window. 
In this example the application window will have a "Close" button in Runtime: 


Sub ApplicationWindowConfig() 

"VBA447 

Dim objAppWindow As HMIApplicationWindow 

Set objAppWindow = ActiveDocument.HMIObjects.AddHMIObject ("AppWindow1", 
"HMIApplicationWindow") 

With objAppWindow 

-CloseButton = True 

End With 

End Sub 


See also 
PictureWindow Object (Page 2029) 
ApplicationWindow Object (Page 1911) 


CollectValue property 


Description 


The CollectValue property specifies as an initial value the current status of the active message 
classes in each case. 


The "Relevant" property has to have the value "TRUE" so that the advanced analog display 
is taken into account when forming the group display . 


ColorAlarmHigh Property 


Description 
Defines or returns the bar color for the "Alarm High" limit value. LONG write-read access. 


The "CheckAlarmHigh" property must have been set to TRUE if the bar color should change 
on reaching the limit value. 
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Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


The "BarGraphLimitConfiguration()" procedure configures the properties of the high limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "50" and the bar color will change to Red. 


Sub BarGraphLimitConfiguration () 


"VBA449 


Dim objBarGraph As HMIBarGraph 


Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "“HMIBarGraph") 
With objBarGraph 


"Set analysis to absolute 


-TypeAlarmHigh 


= False 


"Activate monitoring 
.CheckAlarmHigh = True 

"Set barcolor to "red" 
-ColorAlarmHigh = RGB(255, 0, 0) 
"Set upper limit to "50" 


-AlarmHigh 50 
End With 
End Sub 
See also 
CheckAlarmHigh Property (Page 2170) 
BarGraph Object (Page 1914) 
ColorAlarmLow Property 
Description 


Defines or returns the bar color for the "Alarm Low" limit value. LONG write-read access. 
The "CheckAlarmLow" property must have been set to TRUE if the bar color should change 
on reaching the limit value. 

Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the low limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "10" and the bar color will change to Red. 


Sub BarGraphLimitConfiguration () 
"VBA450 

Dim objBarGraph As HMIBarGraph 
Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "“HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 
.-TypeAlarmLow = False 

"Activate monitoring 
-CheckAlarmLow = True 

"Set barcolor to "red" 
-ColorAlarmLow = RGB(255, 0, 0) 
"Set lower limit to "10" 
-AlarmLow = 10 

End With 

End Sub 


See also 
CheckAlarmLow Property (Page 2171) 
BarGraph Object (Page 1914) 


ColorBottom Property 


Description 


Defines or returns the color for the bottom/right stop of the slider object. LONG write-read 
access. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
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Example: 


The "SliderConfiguration()" procedure accesses the properties of the slider. In this example 
the color for the lower/right view will be set to "Red": 


Sub SliderConfiguration() 

"VBA451 

Dim objSlider As HMISlider 

Set objSlider = ActiveDocument.HMIObjects.AddHMIObject ("SliderObject1", "HMISlider") 
With objSlider 

-ColorBottom = RGB(255, 0, 0) 


End With 
End Sub 
See also 
Slider object (Page 2062) 
ColorChangeType Property 
Description 
TRUE if a color change in the BarGraph object (for instance when a limit value is reached) is 
to take place segment by segment. If set to FALSE, it defines the change of color for the entire 
bar. BOOLEAN write-read access. 
Example: 


The "BarGraphLimitConfiguration()" procedure configures In this example the color change 
will apply to the whole bar: 


Sub BarGraphLimitConfiguration () 

"VBA452 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

-ColorChangeType = False 

End With 

End Sub 


See also 
BarGraph Object (Page 1914) 
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ColorLimitHigh4 Property 


Description 
Defines or returns the color for the "Reserve 4" upper limit value. LONG write-read access. 


The "CheckLimitHigh4" property must have been set to TRUE if the bar color should change 
on reaching the limit value. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the high limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "70" and the bar color will change to Red. 


Sub BarGraphLimitConfiguration () 
"VBA453 

Dim objBarGraph As HMIBarGraph 
Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 
.TypeLimitHigh4 = False 

"Activate monitoring 
-CheckLimitHigh4 = True 

"Set barcolor to "red" 
-ColorLimitHigh4 = RGB(255, 0, 0) 
"Set upper limit to "70" 
-LimitHigh4 = 70 

End With 

End Sub 


See also 
CheckLimitHigh4 Property (Page 2172) 
BarGraph Object (Page 1914) 


ColorLimitHigh5 Property 


Description 


Defines or returns the color for the "Reserve 5" upper limit value. LONG write-read access. 
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The "CheckLimitHigh5" property must have been set to TRUE if the bar color should change 
on reaching the limit value. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the high limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "80" and the bar color will change to "Black". 


Sub BarGraphLimitConfiguration () 
"VBA454 

Dim objBarGraph As HMIBarGraph 
Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 
.TypeLimitHigh5 = False 
"Activate monitoring 
-CheckLimitHigh5 = True 

"Set barcolor to "black" 
-ColorLimitHighS5 = RGB(0O, 0, 0) 
"Set upper limit to "80" 
-LimitHigh5 = 80 

End With 

End Sub 


See also 
CheckLimitHigh5 Property (Page 2173) 
BarGraph Object (Page 1914) 


ColorLimitLow4 Property 


Description 
Defines or returns the color for the "Reserve 4" lower limit value. LONG write-read access. 


The "CheckLimitLow4" property must have been set to TRUE if the bar color should change 
on reaching the limit value. 
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Example: 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


The "BarGraphLimitConfiguration()" procedure configures the properties of the low limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "5" and the bar color will change to "Green". 


Sub BarGraphLimitConfiguration () 


"VBA455 


Dim objBarGraph As HMIBarGraph 


Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "“HMIBarGraph") 
With objBarGraph 
"Set analysis to absolute 


. TypeLimitLow4 


= False 


"Activate monitoring 
-CheckLimitLow4 = True 

"Set barcolor to "green" 
-ColorLimitLow4 = RGB(0, 255, 0) 
"Set lower limit to "5" 


-LimitLow4 = 5 
End With 
End Sub 


See also 


CheckLimitLow4 Property (Page 2174) 
BarGraph Object (Page 1914) 


ColorLimitLow5 Property 


Description 


2188 


Defines or returns the color for the "Reserve 5" lower limit value. LONG write-read access. 


The "CheckLimitLow5" property must have been set to TRUE if the bar color should change 
on reaching the limit value. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the low limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "0" and the bar color will change to "White". 


Sub BarGraphLimitConfiguration () 
"VBA456 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 
.TypeLimitLow5 = False 

"Activate monitoring 

-CheckLimitLow5 = True 

"Set barcolor to "white" 
-ColorLimitLow5 = RGB(255, 255, 255) 
"Set lower limit to "0" 

-LimitLow5 = 0 

End With 

End Sub 


See also 
CheckLimitLow5 Property (Page 2175) 
BarGraph Object (Page 1914) 


ColorToleranceHigh Property 


Description 
Defines or returns the color for the "Tolerance High" high limit value. LONG write-read access. 


The "CheckToleranceHigh" property must have been set to TRUE if the bar color should 
change on reaching the limit value. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the high limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "45" and the bar color will change to "Yellow". 


Sub BarGraphLimitConfiguration () 
"VBA457 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 
.TypeToleranceHigh = Fals 

"Activate monitoring 
-CheckToleranceHigh = Tru 

"Set barcolor to "yellow" 
-ColorToleranceHigh = RGB(255, 255, 0) 
"Set upper limit to "45" 
-ToleranceHigh = 45 

End With 

End Sub 


See also 
CheckToleranceHigh Property (Page 2176) 
BarGraph Object (Page 1914) 


ColorToleranceLow Property 


Description 
Defines or returns the color for the "Tolerance Low" low limit value. LONG write-read access. 


The "CheckToleranceLow" property must have been set to TRUE if the bar color should change 
on reaching the limit value. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the low limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "12" and the bar color will change to "Yellow". 


Sub BarGraphLimitConfiguration () 
"VBA458 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 
.TypeToleranceLow = Fals 

"Activate monitoring 
-CheckToleranceLow = Tru 

"Set barcolor to "yellow" 
-ColorToleranceLow = RGB(255, 255, 0) 
"Set lower limit to "15" 
-ToleranceLow = 15 

End With 

End Sub 


See also 
CheckToleranceLow Property (Page 2177) 
BarGraph Object (Page 1914) 


ColorTop Property 


Description 
Defines or returns the color for the top/left stop of the slider object. LONG write-read access. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
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Example: 


The "SliderConfiguration()" procedure accesses the properties of the slider. In this example 
the color for the upper/left view will be set to "Orange": 


Sub SliderConfiguration() 

"VBA459 

Dim objSlider As HMISlider 

Set objSlider = ActiveDocument.HMIObjects.AddHMIObject ("SliderObject1", "HMISlider") 
With objSlider 

-ColorTop = RGB(255, 128, 0) 


End With 
End Sub 
See also 
Slider object (Page 2062) 
ColorWarningHigh Property 
Description 


Defines or returns the color for the "Warning High" high limit value. LONG write-read access. 
The "CheckWarningHigh" property must have been set to TRUE if the bar color should change 
on reaching the limit value. 

Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
2192 System Manual, 02/2016, ASE37536061-AA 


VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the high limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "75" and the bar color will change to "Red". 


Sub BarGraphLimitConfiguration () 
'VBA460 

Dim objBarGraph As HMIBarGraph 
Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 
.TypeWarningHigh = False 

"Activate monitoring 
.CheckWarningHigh = True 

"Set barcolor to "red" 
-ColorWarningHigh = RGB(255, 0, 0) 
"Set upper limit to "75" 
-WarningHigh = 75 


End With 
End Sub 
See also 
CheckWarningHigh Property (Page 2178) 
BarGraph Object (Page 1914) 
ColorWarningLow Property 
Description 


Defines or returns the color for the "Warning Low" low limit value. LONG write-read access. 


The "CheckWarningLow" property must have been set to TRUE if the bar color should change 
on reaching the limit value. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the low limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "12" and the bar color will change to "Magenta". 


Sub BarGraphLimitConfiguration () 
"VBA461 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "“HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 
.TypeWarningLow = False 

"Activate monitoring 
-CheckWarningLow = True 

"Set barcolor to "magenta" 
-ColorWarningLow = RGB(255, 0, 255) 
"Set lower limit to "12" 
-WarningLow = 12 

End With 

End Sub 


See also 
CheckWarningLow Property (Page 2179) 
BarGraph Object (Page 1914) 


CommonVBSCode Property 


Description 


Defines the higher-level common declaration section of the actions for the active picture or 
returns it. 


The action editor of the Graphics Designer is used to configure actions at events and 
properties. In the declaration section of the actions, you can declare tags for a process image 
as well as create functions and procedures. In Runtime, each VBS action can access these 
tags, functions and procedures if the picture is active. 


If you set "CommonVBSCode", the string is copied to the "Event" and "Property" declaration 
sections in the action editor. Any code there is overwritten. Therefore, set "CommonVBSCode" 
first before setting the subordinate declaration sections with "CommonVBSEventArea" or 
"“CommonVBSPropertyArea". 
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Example 


In the following example, a tag that is common to all picture objects is declared in the active 
picture. The common declaration section is then output : 


Sub DefineTagInActiveDocument 


ActiveDocument.CommonVBSCode = "DIM actionIsdone" & vbCrLf 
sgBox ActiveDocument .CommonVBSCode 

End Sub 

See also 


Document Object (Page 1949) 


CommonVBSEventArea property 


Description 
Defines the "Event" declaration section of the actions for the active picture or returns it. 


The action editor of the Graphics Designer is used to configure actions, for example, at events. 
To this purpose, you can declare tags for a process image as well as create functions and 
procedures in the "Event" declaration section of the actions. In Runtime each VBS action that 
was configured for an event can access these tags, functions and procedures if the picture is 
active. 

If you set "CommonVBSEventArea", the string is copied to the "Event" declaration section in 
the action editor. Any code there is overwritten. Therefore, first read the code set, for example 
with "CommonVBSCode" before you set the declaration section with 
"“CommonVBSEventArea". 


Example 


In the following example, two tags are declared in the active picture. The "Event" declaration 
section is the output: 


Sub DefineTagInActiveDocument 
ActiveDocument.CommonVBSCode = "DIM actionIsdone" & vbCrLf 
ActiveDocument.CommonVBSEventArea = ActiveDocument.CommonVBSEventArea & "DIM 


"eventHasOccurred" 
sgBox ActiveDocument.CommonVBSEventArea 
End Sub 
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CommonVBSPropertyArea property 


Description 
Defines the "Property" declaration section of the actions for the active picture or returns it. 


The action editor of the Graphics Designer is used to configure actions for example at 
properties. To this purpose you can declare tags for a process image as well as create functions 
and procedures in the "Property" declaration section of the actions. In Runtime each VBS 
action that was configured for a property can access these tags, functions and procedures if 
the picture is active. 


If you set "CommonVBSPropertyArea", the string is copied to the "Property" declaration section 
in the action editor. Any code there is overwritten. Therefore, first read the code set, for example 
with "CommonVBSCode" before you set the declaration section with 
"“CommonVBSPropertyArea". 


Example 


In the following example, two tags are declared in the active picture. The "Property" declaration 
section is then output: 


Sub DefineTagInActiveDocument 


ActiveDocument.CommonVBSCode = "DIM actionIsdone" & vbCrLf 
ActiveDocument CommonVBSPropertyArea = ActiveDocument.CommonVBSPropertyArea & "DIM 
propertylIsChanged" 
sgBox ActiveDocument.CommonVBSPropertyArea 
End Sub 


CommandLine Property 


Description 


Returns the start parameter as a string if the application is opened via Start>Execute 
"Grafexe.exe start parameter". Read only access. 


Example: 
In this example a message containing the start parameter is output on opening the document. 


Sub Document _Opened(CancelForwarding As Boolean) 
"VBA462 

sgBox Application.Commandline 

End Sub 
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See also 
Application Object (Page 1909) 


Compiled Property 


Description 


TRUE if the source code of a C script or VB script was successfully compiled. BOOLEAN read 
access. 


Example: 


In the following example a button and a circle will be inserted in the active picture. In Runtime 
the radius of the circle will enlarge every time you click the button. A VB script will be used for 
this purpose: 


Sub IncreaseCircleRadiusWithVBScript () 
"VBA463 
Dim objButton As HMIButton 
Dim objCircleA As HMICircle 
Dim objEvent As HMIEvent 
Dim objVBScript As HMIScriptInfo 
Dim strCode As String 
strCode = "Dim objCircle" & vbCrLf & "Set objCircle = " 
strCode = strCode & "hmiRuntime.ActiveScreen.ScreenItems (""CircleVB"™")" 
strCode = strCode & vbCrLf & "objCircle.Radius = objCircle.Radius + 5" 
Set objCircleA = ActiveDocument.HMIObjects.AddHMIObject ("CircleVB", "HMICircle") 
Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMTButton") 
With objCircleA 
-Top = 100 
-Left = 100 
End With 
With objButton 
-Top = 10 
-Left = 10 
-Width = 200 
Text = "Increase Radius" 
End With 
"On every mouseclick the radius will be increased: 
Set objEvent = objButton.Events (1) 
Set objVBScript = objButton.Events(1).Actions.AddAction (hmiActionCreationTypeVBScript) 
obj VBScript.SourceCode = strCode 
Select Case objVBScript.Compiled 
Case True 
sgBox "Compilation OK!" 
Case False 
sgBox "Errors by compilation!" 
End Select 
End Sub 
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See also 
SourceCode Property (Page 2424) 
ScriptiInfo Object (Page 2058) 


ConfigurationFileName Property 


Description 
Returns the file name and full path of the configuration file for the open project. STRING read 
access. 
Example: 
The "ShowConfigurationFileName() procedure outputs the configuration file path for the 
current picture: 
Sub ShowConfigurationFileName () 
"VBA464 
MsgBox ActiveDocument.Application.ConfigurationFileName 
End Sub 
x 
C:\Siemens\wWinCC\WinCCProjects|mytestproject\GraCs\Default, pdd 
See also 


Application Property (Page 2121) 
Application Object (Page 1909) 


ConnectionPoints property 


Description 


Returns the number of connection points of an object. 
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3.6 VBA Reference 


In this example, a rectangle is inserted and the number of connection points is output: 


Sub CountConnectionPoints() 


"VBA229 


Dim objRectangle As HMIRectangle 
Dim objConnPoints As HMIConnectionPoints 


End Sub 


Set objRectangl 
Set objConnPoints = ActiveDocument.HMIObjects("Rectanglel") .ConnectionPoints 
sgBox "Rectanglel has " & objConnPoints.Count & " connectionpoints." 


= ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 


ConnectorObjects property 


Description 


See also 


Only used internally. 


3DBarGraph Object (Page 1894) 
ActiveXControl Object (Page 1900) 


AdvancedAnalogDisplay object (Page 1901) 
AdvancedStateDisplay object (Page 1905) 


ApplicationWindow Object (Page 1911) 
BarGraph Object (Page 1914) 

Button Object (Page 1921) 

CheckBox Object (Page 1924) 

Circle Object (Page 1928) 

CircularArc Object (Page 1931) 
ComboBox object (Page 1934) 
CustomizedObject Object (Page 1938) 
DataSetObj object (Page 1943) 
DotNetControl object (Page 1954) 
Ellipse Object (Page 1957) 

EllipseArc Object (Page 1960) 
EllipseSegment Object (Page 1963) 
FaceplateObject object (Page 1969) 
GraphicObject Object (Page 1975) 
Group Object (Page 1978) 
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GroupDisplay Object (Page 1980) 
lOField Object (Page 1992) 

Line Object (Page 2004) 

ListBox object (Page 2007) 
MultiLineEdit object (Page 2016) 
ObjConnection object (Page 2019) 
OLEObject Object (Page 2023) 
OptionGroup Object (Page 2025) 
PictureWindow Object (Page 2029) 
PieSegment Object (Page 2032) 
Polygon Object (Page 2035) 
PolyLine Object (Page 2038) 
Rectangle Object (Page 2049) 
RoundButton Object (Page 2052) 
RoundRectangle Object (Page 2055) 
Slider object (Page 2062) 
StaticText Object (Page 2067) 
StatusDisplay Object (Page 2070) 
TextList Object (Page 2076) 
TubeArcObject object (Page 2088) 
TubeDoubleTeeObject object (Page 2090) 
TubePolyline object (Page 2092) 
TubeTeeObject object (Page 2094) 
WPF Control object (Page 2104) 


ConnectorType property 


Description 


Defines the type of connector: 


Automatic Both objects are connected by a polyline made up of horizontal and vertical parts. 
Simple Both objects are connected by a straight line between the connecting points. 
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ControlType property 


Description 
Returns the name range of the control. 


CopyPasteSettings property 


Description 
Only used internally. 

See also 
Application Object (Page 1909) 

CornerRadius property 

Description 
Defines the rounding radius of the rectangle which enclose objects in the advanced analog 
display. The values are defined in pixels. 
The range of values which can be displayed for the corner radius depends on the values set 
for the "height" and "width" properties. The maximum corner radius value which can be 
displayed is equivalent to 50% of the lower one of the "height" or "width" values. The maximum 
value is used if higher values are entered. 

Count Property 

Description 


Returns the number of elements in the specified listing. LONG read access 
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Example: 


In the following example a new picture will be created and a pair of objects will be inserted. 
The number of inserted objects will be output at the end: 


Sub ObjectsInActiveDocument () 

"VBA465 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 

Dim objDocument As Document 

Set objDocument = Application.Documents.Add(hmiOpenDocumentTypeVisible) 

Dim iIndex As Integer 

iIndex = 1 

For iIndex = 1 To 5 

Set objCircle = objDocument.HMIObjects.AddHMIObject ("Circle" & iIndex, "HMICircle") 
Set objRectangle = objDocument.HMIObjects.AddHMIObject ("Rectangle" & iIndex, 
"HMTRectangle") 

With objCircle 

-Top = (10 * iIndex) 

-Left = (10 * iIndex) 

End With 

With objRectangle 

-Top = ((10 * iIndex) + 50) 

-Left = (10 * iIndex) 

End With 

Next iIndex 

sgBox "There are " & objDocument.HMIObjects.Count & " objects in the document" 
End Sub 


See also 
VariableTriggers Object (Listing) (Page 2101) 
Views Object (Listing) (Page 2103) 
VariableStateValues Object (Listing) (Page 2097) 
Toolbarltems Object (Listing) (Page 2085) 
Toolbars Object (Listing) (Page 2081) 
SymbolLibraries Object (Listing) (Page 2073) 
SelectedObjects object (Listing) (Page 2060) 
Properties Object (Listing) (Page 2041) 
HM|Objects Object (Listing) (Page 1990) 
Menultems Object (Listing) (Page 2015) 
Menus Object (Listing) (Page 2011) 
Layers Object (Listing) (Page 2003) 
LanguageTexts Object (Listing) (Page 2000) 
LanguageFonts Object (Listing) (Page 1997) 
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GroupedObjects Object (Listing) (Page 1983) 
Folderltems Object (Listing) (Page 1973) 
Events Object (Listing) (Page 1967) 
Documents Object (Listing) (Page 1952) 
HMIDefaultObjects Object (Listing) (Page 1985) 
DataLanguages Object (Listing) (Page 1942) 
ConnectionPoints Object (Listing) (Page 1936) 
AnalogResultInfos Object (Listing) (Page 1908) 
Actions Object (Listing) (Page 1898) 


CQBackColorOff..ColorOn property 


Description 


Specifies for the selected message type and the state "Came In Acknowledged" which color 
the background of the value to be displayed assumes for flashing status "Off" (CBackColorOff) 
or "On" (CBackColorOn) when the arrival of a message is acknowledged.. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0). 


CQBackFlash property 


Description 


Specifies for the selected message type and status "Came In Acknowledged" whether the 
background of the value to be displayed flashes when the arrival of a message is 
acknowledged. 


CQTextColorOff..ColorOn property 


Description 


Specifies for the selected message type and the state "Came In Acknowledged" which color 
the text of the value to be displayed assumes for flashing status "Off" (CTextColorOff) or "On" 
(CTextColorOn) when the arrival of a message is acknowledged... 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
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Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0). 


CQTextFlash property 


Description 


Specifies for the selected message type and status "Came In Acknowledged" whether the 
background of the text to be displayed flashes when the arrival of a message is acknowledged. 


CTextColorOff..ColorOn property 


Description 
Specifies for the selected message type and the state "Came In" which color the text of the 
value to be displayed assumes for flashing status "Off" (CTextColorOff) or "On" 
(CTextColorOn). 
Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0). 


CTextFlash property 


Description 


Specifies for the selected message type and status "Came In" whether the text of the value to 
be displayed flashes when a message is received. 


CurrentDataLanguage Property 


Description 


Defines the project language or returns the language identifier as a decimal value. LONG read- 
write access. 
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Example: 


The "ShowDataLanguage()" procedure outputs the currently set project language: 


Sub ShowDataLanguage () 
'VBA466 


sgBox Application.CurrentDataLanguage 
End Sub 


See also 


Application Property (Page 2121) 
DataLanguageChanged Event (Page 1762) 
Language-Dependent Configuration with VBA (Page 1624) 


CurrentDesktopLanguage Property 


Description 
Returns the language identifier of the currently set user interface language as a decimal value. 
LONG read access. 

Example: 


The "ShowDesktopLanguage()" procedure outputs the currently set user interface language: 


Sub ShowDesktopLanguage () 
"VBA467 


sgBox Application.CurrentDesktopLanguage 
End Sub 


See also 
Application Property (Page 2121) 
Application Object (Page 1909) 
DesktopLanguageChanged event (Page 1763) 
Language-Dependent Configuration with VBA (Page 1624) 
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CursorControl Property 


Description 
TRUE, when Alpha Cursor mode is activated, the cursor skips to the next field in the TAB 
sequence after exiting the field. BOOLEAN write-read access. 
The CursorMode property must be set to TRUE. 

Example: 


The "IOFieldConfiguration()" procedure accesses the properties of the I/O field. In this example 
the cursor will skip into the next field when another field is exited. For this to work, the Cursor 
mode property must first be set to TRUE. 


Sub I0FieldConfiguration () 

"VBA468 

Dim objIOField As HMIIOField 

Set obj1IOField = ActiveDocument.HMIObjects.AddHMIObject ("IOField1l", "HMIIOField") 
Application.ActiveDocument.CursorMode = True 

With obj1IOField 

-CursorControl = True 

End With 

End Sub 


See also 
TabOrderAlpha Property (Page 2429) 
TabOrderSwitch Property (Page 2433) 
CursorMode Property (Page 2206) 
ActiveDocument Property (Page 2107) 
TextList Object (Page 2076) 
IOField Object (Page 1992) 


CursorMode Property 


Description 


TRUE if the "Alpha Cursor" mode is to be activated. FALSE if the "Tab order" mode is to be 
activated. BOOLEAN write-read access. 
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Example: 


The "ActiveDocumentConfiguration()" procedure accesses the properties of the current picture 
in the Graphics Designer. In this example the "Alpha Cursor" mode will be activated: 


Sub ActiveDocumentConfiguration() 

"VBA469 
Application.ActiveDocument.CursorMode = True 
End Sub 


See also 
CursorControl Property (Page 2206) 
ActiveDocument Property (Page 2107) 
Documents Object (Listing) (Page 1952) 


CustomMenus Property 


Description 


Returns a listing of the available user-defined menus. 


Example: 


The "ShowCustomMenulInformation()" procedure outputs the Key and Label of all user-defined 
menus in the current picture: 


Sub ShowCustomMenuInformation () 

"VBA470 

Dim strKey As String 

Dim strLabel As String 

Dim strOutput As String 

Dim iIndex As Integer 

For iIndex = 1 To ActiveDocument.CustomMenus.Count 

strKey = ActiveDocument.CustomMenus (iIndex) .Key 

strLabel = ActiveDocument.CustomMenus (iIndex) .Label 

strOutput = strOutput & vbCrLf & "Key: " & strKey & " Label: " & strLabel 


ext iIndex 
If 0 = ActiveDocument.CustomMenus.Count Then 
strOutput = "There are no custommenus for the document created." 
End If 
sgBox strOutput 
End Sub 
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See also 
Application Property (Page 2121) 
ActiveDocument Property (Page 2107) 
Menu Object (Page 2009) 


CustomToolbars Property 


Description 


Returns a listing of the available user-defined toolbars. 


Example: 


The "ShowCustomToolbarInformation()" procedure outputs the Key values of all user-defined 


toolbars in the current picture: 


Sub ShowCustomToolbarInformation () 
"VBA471 

Dim strKey As String 

Dim strOutput As String 

Dim iIndex As Integer 


For iIndex = 1 To ActiveDocument.CustomToolbars.Count 
strKey = ActiveDocument.CustomToolbars (iIndex) .Key 
strOutput = strOutput & vbCrLf & "Key: " & strKey 


Next iIndex 


If 0 = ActiveDocument.CustomToolbars.Count Then 


strOutput = "There are no toolbars created for this document." 
End If 
sgBox strOutput 
End Sub 
See also 


Application Property (Page 2121) 
ActiveDocument Property (Page 2107) 
Toolbar Object (Page 2080) 


CycleName Property 


Description 


Returns the name of the specified tag trigger. Read only access. 
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Example: 
See also 

VariableTrigger Object (Page 2099) 
CycleTime Property 
Description 

Returns the cycle time of the specified tag trigger. Read only access. 
Example: 
See also 

VariableTrigger Object (Page 2099) 
CycleType Property 
Description 

Defines or returns the cycle type. 
Example: 


The "DynamicToRadiusOfNewCircle(hmiCircle As IHMICircle)" procedure creates a dynamic 
for the radius of a circle. In this example the radius of the circle will be set every two seconds: 


Sub DynamicToRadiusOfNewCircle () 

"VBA474 

Dim objCircle As hmiCircle 

Dim VariableTrigger As HMIVariableTrigger 

Set objCircle = Application. ActiveDocument.HMIObjects.AddHMIObject ("Circlel", "HMICircle") 
Set VariableTrigger = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeVariableDirect, 
"NewDynamicl") 

VariableTrigger.CycleType = hmiVariableCycleType 2s 

End Sub 
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See also 
VariableTrigger Object (Page 2099) 
Configuring Dynamics in the Properties of Pictures and Objects (Page 1687) 
D 
DataFormat Property 
Description 
Defines or returns the data type of the |OField object. Value range from 0 to 3. 
Data type Assigned Value 
Binary 0 
Decimal 1 
String 2 
Hexadecimal 3 
Example: 


The "|OFieldConfiguration()" procedure accesses the properties of the I/O field. In this 
example, data type "Decimal" will be set for the I/O field: 


Sub I0FieldConfiguration () 

"VBA475 

Dim objJIOField As HMIIOField 

Set obj1IOField = ActiveDocument.HMIObjects.AddHMIObject ("IOField1i", "HMIIOField") 
With obj1IOField 

.-DataFormat = 1 

End With 

End Sub 


See also 
IOField Object (Page 1992) 


DefaultHMlObjects Property 


Description 
Returns the HMIDefaultObjects listing. 
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Example: 


The "ShowDefaultObjectNames()" procedure outputs all the object names contained in the 
HM|DefaultObjects listing: 


Sub ShowDefaultObjectNames () 

"VBA476 

Dim strOutput As String 

Dim ilIndex As Integer 

For iIndex = 1 To Application.DefaultHMIObjects.Count 

strOutput = strOutput & vbCrLf & Application.DefaultHMIObjects (iIndex) .ObjectNam 
ext iIndex 

sgBox strOutput 


End Sub 
See also 
HMIDefaultObjects Object (Listing) (Page 1985) 
DestinationLink Property 
Description 


Returns the Destination object. Use the DestinationLink property to configure the destination 
object in the case of a direct connection. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 2211 


VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


Use the DestinationLink property to return the DestLink object. In the following example the X 
position of "Rectangle_A" is copied to the Y position of "Rectangle_B" in Runtime by clicking 
on the button: 


Sub DirectConnection () 

"VBA477 

Dim objButton As HMIButton 

Dim objRectangleA As HMIRectangle 

Dim objRectangleB As HMIRectangle 

Dim objEvent As HMIEvent 

Dim objDirConnection As HMIDirectConnection 

Set objRectangleA = ActiveDocument.HMIObjects.AddHMIObject ("Rectangle A", "HMIRectangle") 
Set objRectangleB = ActiveDocument.HMIObjects.AddHMIObject ("Rectangle B", "HMIRectangle") 
Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMTButton") 

With objRectangleA 

-Top = 100 

-Left = 100 


With objRectangleB 

-Top = 250 

-Left = 400 

-BackColor = RGB(255, 0, O) 
End With 
With objButton 
-Top = 10 
-Left = 10 
-Width = 100 
-Text = "SetPosition" 
End With 

' 


"Directconnection is initiated by mouseclick: 

Set objDirConnection = 

objButton.Events (1).Actions.AddAction (hmiActionCreationTypeDirectConnection) 
With objDirConnection 

"Sourceobject: Property "Top" of Rectangle A 


-SourceLink.Type = hmiSourceTypeProperty 
-SourceLink.ObjectName = "Rectangle A" 
-SourceLink.AutomationName = "Top" 
' 
'Targetobject: Property "Left" of Rectangle B 
.DestinationLink.Type = hmiDestTypeProperty 
.DestinationLink.ObjectName = "Rectangle B" 
.DestinationLink.AutomationName = "Left" 
End With 
End Sub 
See also 


AutomationName Property (Page 2124) 
ObjectName Property (Page 2347) 
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Type Property (Page 2450) 
DirectConnection Object (Page 1947) 


Direction Property 


Description 
Defines or returns the bar direction. BOOLEAN write-read access. 
Slider 
Defines or returns the position of the Slider object. BOOLEAN write-read access. 
Position/Bar Axis Assigned Value 
Vertical/Negative TRUE 
Horizontal/Positive FALSE 
Example: 


The "SliderConfiguration()" procedure accesses the properties of the slider. In this example 
the position of the Slider object will be set to "Vertical": 


Sub SliderConfiguration() 

"VBA478 

Dim objSlider As HMISlider 

Set objSlider = ActiveDocument.HMIObjects.AddHMIObject ("SliderObject1", "HMISlider") 
With objSlider 

.Direction = True 

End With 

End Sub 


See also 
Slider object (Page 2062) 
3DBarGraph Object (Page 1894) 


DisablePerformanceWarnings property 


Description 


Only used internally. 


See also 
Application Object (Page 1909) 
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DisableVBAEvents Property 


Description 
TRUE if Event Handling is disabled. BOOLEAN write-read access. 


Example: 
The "DisableVBAEvents()" procedure disables Event Handling: 


Sub DisableVBAEvents () 


'VBA479 
Application.DisableVBAEvents = Fals 
End Sub 
See also 
Application Object (Page 1909) 
Event Handling (Page 1709) 
Display property 
Description 
Only used internally. 
See also 
ObjConnection object (Page 2019) 
DisplayName Property 
Description 


Returns the name of the property attribute. STRING read access. 


Thus the expression "MsgBox 
ActiveDocument.HMlObjects("Circle_1").Properties("Height").DisplayName" would output the 
result "Height". 


WinCC: Scripting (VBS, ANSI-C, VBA) 
2214 System Manual, 02/2016, ASE37536061-AA 


VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


The "ShowAllObjectDisplayNames()" procedure outputs all the property attribute names of 
standard objects contained in the message box: 


Sub ShowAllObjectDisplayNames () 
"VBA480 
Dim strOutput As String 
Dim iIndexl As Integer 


iIndexl = 1 

strOutput = "List of all properties-displaynames from object """ & 
Application.DefaultHMIObjects(1l).ObjectName & """" & vbCrLf & vbCrLf 
For iIndexl = 1 To Application.DefaultHMIObjects (1) .Properties.Count 


strOutput = strOutput & Application.DefaultHMIObjects(1).Properties(iIndexl) .DisplayName & 
W ra W 

ext iIndexl 

sgBox strOutput 


End Sub 
See also 
Property Object (Page 2042) 
DisplayOptions Property 
Description 
Defines the assignment of the "Button" or "Round button" object or returns its value. Value 
range from 0 to 3. 
Assignment Assigned Value 
Graphic or text 0 
Graphic and text 1 
Text only 2 
Graphic only 3 
Example: 


The "ButtonConfiguration()" procedure accesses the properties of the button. 
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In this example the button is assigned "Graphic and text": 


Sub ButtonConfiguration () 
"VBA814 
Dim objbutton As HMIButton 


Set objbutton = ActiveDocument.HMIObjects.AddHMIObject ("Buttonl", "“HMIButton") 
With objbutton 


-DisplayOptions = 1 


End With 
End Sub 
See also 
Button Object (Page 1921) 
DisplayText Property 
Description 
Returns the value for the "Label" or "TooltipText" property of the following objects (STRING 
read access): 
@ Menu Object 
@ Menultem Object 
e Toolbarltem Object 
Example: 


The "ShowLabelTexts()" procedure outputs all the labels of the first user-defined menu in the 
current picture: 


Sub ShowLabelTexts () 

'VBA481 

Dim objLangText As HMILanguageText 

Dim ilndex As Integer 

For iIndex = 1 To ActiveDocument.CustomMenus (1) .LDLabelTexts.Count 
Set objLangText = ActiveDocument.CustomMenus (1) .LDLabelTexts (iIndex) 
sgBox objLangText.DisplayName 

Next iIndex 

End Sub 
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See also 
ToolTipText Property (Page 2445) 
Label Property (Page 2288) 
Toolbarltem Object (Page 2083) 
LanguageText Object (Page 1999) 
Menultem Object (Page 2013) 
Menu Object (Page 2009) 


Documents Property 


Description 


Returns the Documents listing containing all open pictures. The open pictures are in 
chronological order. 


Example: 


In the following example the names of all open pictures are output: 


Sub ShowDocuments () 

"VBA482 

Dim colDocuments As Documents 

Dim objDocument As Document 

Dim strOutput As String 

Set colDocuments = Application.Documents 
strOutput = "List of all opened documents:" & vbCrLf 
For Each objDocument In colDocuments 

strOutput = strOutput & vbCrLf & objDocument.Name 
ext objDocument 

sgBox strOutput 

End Sub 


See also 
Application Property (Page 2121) 
Application Object (Page 1909) 
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DrawinsideFrame property 


Description 


Defines for all line thicknesses greater than "1" whether the border lines are to be drawn inside 
the object frame or symmetrically on the frame. 


Yes The border lines are drawn inside the object frame. 


No The border lines are drawn symmetrically on the object frame. 


DropDownListStyle property 


Description 
Defines whether the entries in the "TextList" object are displayed in a drop-down list box. 


Dynamic Property 


Description 


Returns the dynamics of a property. 


Example: 


Use the Dynamic property if you wish to return, say, an existing dynamic. In the following 
example all possibly available object property dynamics are output in the active picture: 


Sub ShowPropertiesDynamicsofAllObjects () 
"VBA483 

Dim objObject As HMIObject 

Dim colObjects As HMIObjects 

Dim colProperties As HMIProperties 

Dim objProperty As HMIProperty 

Dim strOutput As String 

Set colObjects = Application.ActiveDocument.HMIObjects 
For Each objObject In colObjects 

Set colProperties = objObject.Properties 
For Each objProperty In colProperties 

If 0 <> objProperty.DynamicStateType Then 


strOutput = strOutput & vbCrLf & objObject.ObjectName & " - " & objProperty.DisplayName 
& ": Statetype " & objProperty.Dynamic.DynamicStateType 
End If 


ext objProperty 
ext objObject 
sgBox strOutput 
End Sub 
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See also 
Property Object (Page 2042) 


DynamicStateType property 


Description 
Only used internally. 
See also 
VBA Reference: ActionDynamic (Page 1747) 
E 
EditAtOnce Property 
Description 
TRUE, if accessing the field with the <TAB> key permits input immediately and without further 
action. BOOLEAN write-read access. 
Example: 


The "lOFieldConfiguration()" procedure accesses the properties of the I/O field. In this example 
it shall be possible to enter input on skipping into the I/O field: 


Sub IOFieldConfiguration () 

"VBA484 

Dim objJIOField As HMIIOField 

Set obj1lOField = ActiveDocument.HMIObjects.AddHMIObject ("IOField1i", "HMIIOField") 
With obj1IOField 

-EditAtOnce = True 

End With 

End Sub 


See also 
TextList Object (Page 2076) 
IOField Object (Page 1992) 
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ElseCase Property 


Description 
Defines or returns the value for the dynamic property outside of the configured value range. 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog, a tag name will be assigned and three analog value ranges will be created: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
"VBA485 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 

-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.Add 50, 40 
-AnalogResultInfos.Add 100, 80 
-AnalogResultInfos.ElseCase = 100 
End With 

End Sub 


See also 
AnalogResultInfos Object (Listing) (Page 1908) 
AnalogResultInfo Object (Page 1907) 
Add Method (AnalogResultInfos Listing) (Page 1787) 


Enabled Property 


Description 


TRUE if the menu, the menu entry or the icon is activated and can be selected. Applies only 
to user-defined menus and toolbars. BOOLEAN write-read access. 
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Example: 
The "CreateMenultem()" procedure creates the "Delete Objects" menu and adds two menu 
entries ("Delete Rectangles" and "Delete Circles"): In this example the second menu point in 
user-defined menu "Delete Objects" is grayed out and cannot be selected in the Graphics 
Designer: 
Sub DisableMenulItem() 
"VBA486 
Dim objMenu As HMIMenu 
Dim objMenuItem As HMIMenulItem 
"Add a new menu "Delete objects" 
Set objMenu = ActiveDocument.CustomMenus.InsertMenu(1, "DeleteObjects", "Delete objects") 
‘Add two menuitems to the new menu 
Set objMenuItem = objMenu.Menultems.InsertMenuItem(1, "DeleteAllRectangles", "Delet 
rectangles") 
Set objMenulItem = objMenu.MenuItems.InsertMenuItem(2, "DeleteAllCircles", "Delete circles") 
"Disable menuitem "Delete circles" 
With ActiveDocument.CustomMenus ("DeleteObjects") .MenulItems ("DeleteAllCircles") 
-Enabled = False 
End With 
End Sub 
See also 
Toolbarltem Object (Page 2083) 
Menultem Object (Page 2013) 
Menu Object (Page 2009) 
Configuring Menus and Toolbars (Page 1626) 
EnableFlashing property 
Description 


Specifies whether the value for status "OK" and "Simulation" appears flashing or not in the 
advanced analog display in Runtime. 


For the flashing to be visible in Runtime, the font flashing color must be different to the 
background flashing color. 
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EndAngle Property 


Description 


Defines or returns the end of the object for the CircularArc, EllipseArc, EllipseSegment and 
PieSegment objects. The information is in counterclockwise direction in degrees, beginning at 
the 12:00 clock position. 


Example: 


The "PieSegmentConfiguration()" procedure accesses the properties of the Pie Segment. In 
this example the pie segment begins at 40° and ends at 180°: 


Sub PieSegmentConfiguration () 

"VBA487 

Dim objPieSegment As HMIPieSegment 

Set objPieSegment = ActiveDocument.HMIObjects.AddHMIObject ("PieSegment1", "HMIPieSegment") 
With objPieSegment 

-StartAngle = 40 

-EndAngle = 180 


End With 

End Sub 

See also 
StartAngle Property (Page 2426) 
PieSegment Object (Page 2032) 
EllipseSegment Object (Page 1963) 
EllipseArc Object (Page 1960) 
CircularArc Object (Page 1931) 

EventQuitMask property 

Description 


The events "Operator request" and "Measuring point blocked" are not acknowledgeable events 
in the PCS 7 environment. Using the "@EventQuit" tag and the "EventQuitMask" property in 
Runtime, these events are automatically indicated as acknowledged to prevent flashing during 
the calculation of the group displays. The start value of the attribute is then 0x00000011 (17). 
The value of the "EventQuitMask" property should be identical for all group display objects, 
advanced analog display and advanced status display, and for the "@EventQuit" tag. 


By setting further acknowledgment bits, you can indicate other events as being acknowledged 
as well with the display of the group display object and the advanced analog and status display. 
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Description 
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Returns the Events listing. Use the Events property to define the event that will trigger an 
action. Use the index number to define the event that is intended to be configured: 


e You configure an action on a property with VBA by using the "Events(9)" property, where 
the index "1" stands for the event "Upon change": 


e Toconfigure an action onto an object with the aid of VBA, use the "Events(Index)" property, 
where "Index" stands for the trigger event (see table): 


Index 


EventType (depending upon the object used) 
hmiEventTypeNotDefined 


hmiEventTypeMouseClick 


hmiEventTypeMouseLButtonDown 


hmiEventTypeMouseLButtonUp 


hmiEventTypeMouseRButtonDown 


hmiEventTypeMouseRButtonUp 


hmiEventTypeKeyboardDown 
hmiEventTypeKeyboardUp 


COINIOD)/aA!R])w]hmMs]—->|]o 


hmiEventTypeFocusEnter 


<e} 


hmiEventTypeObjectChange 


hmiEventTypeOpenPicture 


hmiEventTypePictureOpen 


hmiEventTypePictureClose 


hmiEventTypeObjectDefined 


hmiEventTypeFocusEnter 


hmiEventTypeLastTriggerType 


af/oafoa}]o}] oa] oa] 
O;a;HR}/wWwl)myo)]—->/o 


hmiEventTypeObjSpecificTriggerStart 
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Example: 


In the following example the X position of "Rectangle_A" is copied to the Y position of 
"Rectangle_B" in Runtime by clicking on the button: 


Sub DirectConnection () 

"VBA488 

Dim objButton As HMIButton 

Dim objRectangleA As HMIRectangle 

Dim objRectangleB As HMIRectangle 

Dim objEvent As HMIEvent 

Dim objDirConnection As HMIDirectConnection 

Set objRectangleA = ActiveDocument.HMIObjects.AddHMIObject ("Rectangle A", "HMIRectangle") 
Set objRectangleB = ActiveDocument.HMIObjects.AddHMIObject ("Rectangle B", "HMIRectangle") 
Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMTButton") 

With objRectangleA 

-Top = 100 

-Left = 100 


With objRectangleB 

-Top = 250 

-Left = 400 

-BackColor = RGB(255, 0, O) 
End With 
With objButton 
-Top = 10 
-Left = 10 
-Width = 100 
-Text = "SetPosition" 
End With 

' 


"Directconnection is initiated by mouseclick: 

Set objDirConnection = 

objButton.Events (1) .Actions.AddAction (hmiActionCreationTypeDirectConnection) 
With objDirConnection 

"Sourceobject: Property "Top" of Rectangle A 


-SourceLink.Type = hmiSourceTypeProperty 
-SourceLink.ObjectName = "Rectangle A" 
-SourceLink.AutomationName = "Top" 
' 
"Targetobject: Property "Left" of Rectangle B 
.DestinationLink.Type = hmiDestTypeProperty 
.DestinationLink.ObjectName = "Rectangle B" 
.-DestinationLink.AutomationName = "Left" 
End With 
End Sub 
See also 


Events Object (Listing) (Page 1967) 
Configuring Event-Driven Actions with VBA (Page 1699) 
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EventName property 


Description 
Returns the name of the "Event" object. 


Example 


3.6 VBA Reference 


In this example the event names and event types of all objects in the active pictures are put 
out. In order for this example to work, insert some objects into the active picture and configure 


different events. 


Sub ShowEventsOfAllObjectsInActiveDocument () 
"VBA252 

Dim colEvents As HMIEvents 

Dim objEvent As HMIEvent 

Dim iMax As Integer 

Dim iIndex As Integer 

Dim iAnswer As Integer 

Dim strEventName As String 

Dim strObjectName As String 

Dim varEventType As Variant 

iIndex = 1 

iMax = ActiveDocument.HMIObjects.Count 

For iIndex = 1 To iMax 

Set colEvents = ActiveDocument.HMIObjects (iIndex) 
strObjectName = ActiveDocument.HMIObjects (iIndex) .ObjectNam 
For Each objEvent In colEvents 

= objEvent.EventNam 

= objEvent.EventTyp 


-Events 


strEventNam 


varEventTyp 


iAnswer = MsgBox("Objectname: " & strObjectName & vbCrLf & "Eventtype: 
vbCrLf & "Eventname: " & strEventName, vbOKCancel1) 

If vbCancel = iAnswer Then Exit For 

ext objEvent 

If vbCancel = iAnswer Then Exit For 

ext iIndex 

End Sub 


EventType Property 


Description 
Returns the event type that is configured on the specified object. 


" 


& varEventType & 


Index EventType (depending upon the object used) 
0 hmiEventTypeNotDefined 

1 hmiEventTypeMouseClick 

2 hmiEventTypeMouseLButtonDown 

3 hmiEventTypeMouseLButtonUp 
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EventType (depending upon the object used) 
hmiEventTypeMouseRButtonDown 


hmiEventTypeMouseRButtonUp 


hmiEventTypeKeyboardDown 


hmiEventTypeKeyboardUp 
hmiEventTypeFocusEnter 


9 hmiEventTypeObjectChange 

10 hmiEventTypeOpenPicture 

11 hmiEventTypePictureOpen 

12 hmiEventTypePictureClose 

13 hmiEventTypeObjectDefined 

14 hmiEventTypeFocusEnter 

15 hmiEventTypeLastTriggerType 

16 hmiEventTypeObjSpecificTriggerStart 


Example: 


Use the EventType property to edit a previously configured event. In the following example 


the event "Mouse Action" will be configured, but then changed to "Pressed": 


Sub AddActionToObjectTypeCScript () 
"VBA489 

Dim objEvent As HMIEvent 

Dim objCScript As HMIScriptInfo 
Dim objCircle As HMICircle 


Set objCircle = ActiveDocument .HMIObjects.AddHMIObject ("Circle AB", "HMICircle") 


"C-action is initiated by click on object circle 


Set objEvent = objCircle.Events (1) 


Set objCScript = objEvent.Actions.AddAction (hmiActionCreationTypeCScript) 


sgBox "the type of the projected 
End Sub 


See also 


Events Object (Listing) (Page 1967) 


vent is " & obj 


Fvent.EventType 


Configuring Event-Driven Actions with VBA (Page 1699) 
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Exponent Property 


Description 


TRUE if numbers are to be displayed on the BarGraph object using exponents (e.g. '"1.00e 
+000"). BOOLEAN write-read access. 


Example: 


The "BarGraphConfiguration()" procedure configures In this example numbers are to be 
displayed on the bar using exponents: 


Sub BarGraphConfiguration () 

"VBA490 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

-Exponent = True 

End With 

End Sub 


See also 
BarGraph Object (Page 1914) 


ExtendedOperation Property 


Description 
TRUE if the slider on the Slider object is set to the associated end value (minimum value/ 
maximum value). This is done by clicking the mouse in an area outside the current regulator 
setting. BOOLEAN write-read access. 

Example: 


The "SliderConfiguration()" procedure accesses the properties of the slider. In this example 
the ExtendedOperation property will be set to TRUE: 


Sub SliderConfiguration() 

"VBA491 

Dim objSlider As HMISlider 

Set objSlider = ActiveDocument.HMIObjects.AddHMIObject ("SliderObject1i", "HMISlider") 
With objSlider 

.ExtendedOperation = True 

End With 

End Sub 
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See also 
Slider object (Page 2062) 


ExtendedZoomingEnable Property 


Description 


TRUE, if the selected process picture in Runtime may be zoomed in or out using the mouse 
wheel. This happens by pushing the <CTRL> key while the mouse wheel is turned. If the mouse 
wheel is turned away from the palm of the hand, the zoom factor increases. 


BOOLEAN write-read access. 

Requirements for using the zoom function: 

@ Mouse driver by Logitech or Microsoft Intellimouse 
e Mouse wheel must be set to "Autoscroll". 


e@ Inthe computer properties, the "Graphics Runtime" tab control must have the "Extended 
zooming" function enabled for all process pictures. 


Example: 
The procedure "DocConfiguration()" accesses picture properties. 


In this example, the property ExtendedZoomingEnable is set to TRUE: 


Sub DocConfiguration () 
"VBA815 

Dim objDoc As Document 

Set objDoc = ActiveDocument 
With objDoc 
-ExtendedZoomingEnable = True 
End With 

End Sub 


FaceplateType property 


Description 


Sets the faceplate type of the faceplate instance and returns its name. The faceplate type is 
"Const" and can therefore only be set once. 
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Usage 


Use the Add method to create a new "faceplate instance" object in a picture. 
"Properties.Item(3)" is used to access the FaceplateType property: 


Sub FaceplateInstance and Properties () 
"VBA847 
Dim objFaceplateInstance As HMIFaceplateObject 


Set objFaceplateInstance = ActiveDocument.HMIObjects.AddHMIObject ("faceplate instance", 
"HMI FaceplateObject") 

objFaceplateInstance.Properties.Item(3).value = "Faceplatel.fpt" 

sgBox "Faceplate """ & objFaceplateInstance.Properties.Item(3).value & """ is used." 
End Sub 


Family Property 


Description 


Defines or returns the language-dependent font. 
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Example: 


The following example sets the font attributes of a button for French and English: 


Sub ExampleForLanguageFonts () 
"VBA492 


Dim colLangFonts As HMILanguageFonts 

Dim objButton As HMIButton 

Dim iStartLangID As Integer 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", 
iStartLangID = Application.CurrentDataLanguage 

With objButton 

-Text = "Command" 

-Width = 100 

End With 


Set colLangFonts 


objButton.LDFonts 


'To do typesettings for french: 


With colLangFonts.ItemByLCID (1036) 
-Family = "Courier New" 

-Bold = True 

-Italic = False 

-Underlined = Tru 

-Size = 12 


End With 
' 


'To do typesettings for english: 
With colLangFonts.ItemByLCID (1033) 
.Family "Times New Roman" 

-Bold False 

-Italic True 

.-Underlined = Fals 

.Size 14 

End With 
With objButton 

Application. CurrentDataLanguage 
-Text "Command" 
sgBox "Datalanguage is changed 
Application. CurrentDataLanguage 
-Text "Command" 

sgBox "Datalanguage is 


1036 


in french" 
1033 


changed in english" 


Application.CurrentDataLanguage = iStartLangID 
sgBox "Datalanguage is changed back to startlanguage." 
End With 
End Sub 
See also 
Underlined Property (Page 2460) 
Size Property (Page 2419) 
Parent Property (Page 2359) 
2230 
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Italic Property (Page 2282) 
LanguagelD Property (Page 2289) 
Bold Property (Page 2151) 
Application Property (Page 2121) 
LanguageFont Object (Page 1996) 


FillBackColor property 


Description 


Only used internally. 


See also 
Document Object (Page 1949) 


FillColor Property 


Description 
Defines or returns the fill pattern color for the object. LONG read-write access. 
Determination of Color Value 
The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 

Example: 


The "RectangleConfiguration()" procedure accesses the properties of the rectangle. In this 
example the background color will be set to "Yellow". 


Sub RectangleConfiguration () 


"VBA493 
Dim objRectangle As HMIRectangle 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 


With objRectangle 

»-FillColor = RGB(255, 255, 0) 
End With 

End Sub 
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See also 


Filling Property 


Description 
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Button Object (Page 1921) 
StaticText Object (Page 2067) 
Slider object (Page 2062) 

TextList Object (Page 2076) 
RoundRectangle Object (Page 2055) 
RoundButton Object (Page 2052) 
Rectangle Object (Page 2049) 
Polygon Object (Page 2035) 
PieSegment Object (Page 2032) 
OptionGroup Object (Page 2025) 
GroupDisplay Object (Page 1980) 
GraphicObject Object (Page 1975) 
IOField Object (Page 1992) 
EllipseSegment Object (Page 1963) 
Ellipse Object (Page 1957) 
Document Object (Page 1949) 
Circle Object (Page 1928) 
CheckBox Object (Page 1924) 
BarGraph Object (Page 1914) 
3DBarGraph Object (Page 1894) 


TRUE if an object with closed frame lines (such as a Circle or Rectangle) can be filled (as in 
the fill level of a tank, for example). BOOLEAN write-read access. 


To set the fill level of the object, use the Fillinglndex property. 
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Example: 


3.6 VBA Reference 


The "RectangleConfiguration()" procedure accesses the properties of the rectangle. In this 


example a rectangle can be used to display the fill level: 


Sub RectangleConfiguration () 
"VBA494 


Dim objRectangle As HMIRectangle 


Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 


With objRectangle 
-Filling = True 
End With 


End Sub 


See also 


Fillinglndex Property (Page 2233) 
StaticText Object (Page 2067) 
Slider object (Page 2062) 
RoundRectangle Object (Page 2055) 
RoundButton Object (Page 2052) 
Rectangle Object (Page 2049) 
Polygon Object (Page 2035) 
PieSegment Object (Page 2032) 
OptionGroup Object (Page 2025) 
GraphicObject Object (Page 1975) 
EllipseSegment Object (Page 1963) 
Ellipse Object (Page 1957) 

Circle Object (Page 1928) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 


Fillinglndex Property 


Description 


Defines the percentage value (relative to the height of the object) to which to fill an object with 


closed frame lines (such as a Circle or Rectangle). 


The fill level is represented by the current background color. The unfilled background is 


transparent. 
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Example: 


The "RectangleConfiguration()" procedure accesses the properties of the rectangle. In this 


example the rectangle will be filled to 50%: 


Sub RectangleConfiguration () 
"VBA495 
Dim objRectangle As HMIRectangle 


Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 


With objRectangle 
-Filling = True 
-FillingIndex = 50 
End With 

End Sub 


See also 
PieSegment Object (Page 2032) 
FillColor Property (Page 2231) 
BackColor Property (Page 2131) 
StaticText Object (Page 2067) 
Slider object (Page 2062) 
RoundRectangle Object (Page 2055) 
RoundButton Object (Page 2052) 
Rectangle Object (Page 2049) 
Polygon Object (Page 2035) 
OptionGroup Object (Page 2025) 
GraphicObject Object (Page 1975) 
EllipseSegment Object (Page 1963) 
Ellipse Object (Page 1957) 
Circle Object (Page 1928) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 


FillingDirection property 


Description 


0 = the object enclosed in a frame line is filled from bottom to top. 


1 = the object enclosed in a frame line is filled from top to bottom. 
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2 = the object enclosed in a frame line is filled from left to right. 
3 = the object enclosed in a frame line is filled from right to left. 


Write/Read access. 
Use the "FillingDirection" property to set the object fill direction. 


Example 


The "RectangleConfiguration()" procedure accesses the properties of the rectangle. In this 
example, the object is filled from left to right. 


Sub RectangleConfiguration () 

"VBA906 

Dim objRectangle As HMIRectangle 

Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 
With objRectangle 

-FillingDirection = 2 

End With 

End Sub 


FillStyle Property 


Description 


Defines or returns the fill style for the object. 


Fill pattern Fill pattern Fill pattern 

< Transparent } | 65536 

< Solid > 0 

| 1048576 196611 196627 
a 1048577 196612 196628 
— 1048578 196613 196629 
1048579 196614 196630 
Ei 1048832 196615 196631 
— 1048833 196616 196632 
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Fill pattern Value Fill pattern Value Fill pattern Value 
1048834 196617 196633 
1048835 196618 196634 
131072 196619 QRRRRRLN 196635 

SRE 
131073 196620 HA 196636 
131074 196621 == 196637 
131075 196622 196638 
131076 196623 196639 
196608 196624 YYy 196640 
We 
196609 196625 196641 
196610 196626 HII] 196642 


Example 


The "RectangleConfiguration()" procedure accesses the properties of the rectangle. In this 
example the fill pattern will be set to the value "196642": 


Sub RectangleConfiguration () 
"VBA496 

Dim objRectangle As HMIRectangle 
Set objRectangl 
With objRectangle 
-FillStyle = 196642 


End With 

End Sub 

See also 
TextList Object (Page 2076) 
StaticText Object (Page 2067) 
Slider object (Page 2062) 
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= ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 
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RoundRectangle Object (Page 2055) 
RoundButton Object (Page 2052) 
Rectangle Object (Page 2049) 
Polygon Object (Page 2035) 
PieSegment Object (Page 2032) 
OptionGroup Object (Page 2025) 
IOField Object (Page 1992) 
GraphicObject Object (Page 1975) 
EllipseSegment Object (Page 1963) 
Ellipse Object (Page 1957) 
Document Object (Page 1949) 
Circle Object (Page 1928) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 
BarGraph Object (Page 1914) 


FillStyle2 Property 


Description 


Defines or returns the fill pattern of the bar for the BarGraph object. 


Fill pattern Fill pattern Fill pattern 


€ Transparent > 
< Solid > 0 


| 1048576 196611 196627 
o— 1048577 196612 196628 
1048578 196613 196629 
_ 1048579 196614 196630 
Ei 1048832 196615 196631 
— 1048833 196616 196632 
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Fill pattern Value Fill pattern Value Fill pattern Value 
1048834 196617 196633 
1048835 196618 196634 
131072 196619 QRRRRRLN 196635 

SRE 
131073 196620 HA 196636 
131074 196621 == 196637 
131075 196622 196638 
131076 196623 196639 
196608 196624 YYy 196640 
We 
196609 196625 196641 
196610 196626 HII] 196642 


Example 


The "BarGraphConfiguration()" procedure configures In this example the bar pattern will be 
set to "196642": 


Sub BarGraphConfiguration () 

"VBA497 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "“HMIBarGraph") 
With objBarGraph 

-FillStyle2 = 196642 

End With 

End Sub 


See also 
BarGraph Object (Page 1914) 
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FillStyleAlignment property 


Description 
Defines the alignment of the fill pattern for the process picture. 
Normal The fill pattern refers to the process picture. In runtime, no scaling is 
performed when opening the picture. 
Stretched (window) _ The fill pattern refers to the window in the Graphics Designer. In run- 
time, scaling is performed when opening the picture. 
FlashBackColor Property 
Description 
TRUE, when flashing of the background is activated. BOOLEAN write-read access 
Note 
A change to the attribute does not automatically deactivate the "Windows Style" attribute. 
Example: 


The "RectangleConfiguration()" procedure accesses the properties of the rectangle. In this 
example, background flashing is activated: 


Sub RectangleConfiguration () 


"VBA498 
Dim objRectangle As HMIRectangle 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 


With objRectangle 
-FlashBackColor = True 
End With 

End Sub 


See also 
RoundButton Object (Page 2052) 
StaticText Object (Page 2067) 
Slider object (Page 2062) 
TextList Object (Page 2076) 
RoundRectangle Object (Page 2055) 
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Rectangle Object (Page 2049) 
Polygon Object (Page 2035) 
PieSegment Object (Page 2032) 
OptionGroup Object (Page 2025) 
GraphicObject Object (Page 1975) 
lOField Object (Page 1992) 
EllipseSegment Object (Page 1963) 
Ellipse Object (Page 1957) 

Circle Object (Page 1928) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 
BarGraph Object (Page 1914) 


FlashBorderColor Property 


Description 


Example: 


Sub RectangleCo 
"VBA499 

Dim objRectangl 
Set objRectangl 


TRUE, when flashing of the object lines is activated. BOOLEAN write-read access. 


The "RectangleConfiguration()" procedure accesses the properties of the rectangle. In this 


example, flashing of the border is activated: 


nfiguration () 


e As HMIRectangle 


With objRectang 
.FlashBorderCol 
End With 

End Sub 


See also 


2240 


= ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 


le 
or = True 


StaticText Object (Page 2067) 
StatusDisplay Object (Page 2070) 
Slider object (Page 2062) 

TextList Object (Page 2076) 
RoundRectangle Object (Page 2055) 
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RoundButton Object (Page 2052) 
Rectangle Object (Page 2049) 
PolyLine Object (Page 2038) 
Polygon Object (Page 2035) 
PieSegment Object (Page 2032) 
OptionGroup Object (Page 2025) 
Line Object (Page 2004) 
GraphicObject Object (Page 1975) 
IOField Object (Page 1992) 
EllipseSegment Object (Page 1963) 
EllipseArc Object (Page 1960) 
Ellipse Object (Page 1957) 
CircularArc Object (Page 1931) 
Circle Object (Page 1928) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 


FlashFlashPicture Property 


Description 


Example: 


3.6 VBA Reference 


TRUE, when flashing of the flash picture is activated. BOOLEAN write-read access 


The "StatusDisplayConfiguration()" procedure accesses the properties of the Status Display. 


In this example, flashing of the Flash Picture is activated: 


Sub StatusDisplayConfiguration () 


"VBA500 


Dim objsDisplay As HMIStatusDisplay 
Set objsDisplay = ActiveDocument.HMIObjects.AddHMIObject ("StatusDisplayl", 
"HMIStatusDisplay") 

With objsDisplay 
-FlashFlashPicture = True 


End With 
End Sub 
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See also 
StatusDisplay Object (Page 2070) 
FlashForeColor Property 
Description 
TRUE, when flashing of the text is activated. BOOLEAN write-read access. 
Note 
A change to the attribute does not automatically deactivate the "Windows Style" attribute. 
Example: 


The "ButtonConfiguration()" procedure accesses the properties of the button. In this example, 
text flashing is activated: 


Sub ButtonConfiguration() 

"VBA501 

Dim objButton As HMIButton 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Buttonl", "“HMIButton") 
With objButton 

.FlashForeColor = True 

End With 

End Sub 


See also 
TextList Object (Page 2076) 
StaticText Object (Page 2067) 
OptionGroup Object (Page 2025) 
IOField Object (Page 1992) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 


FlashPicReferenced Property 


Description 


TRUE if the Flash Picture assigned in the Status Display object is to be saved. Otherwise, only 
the associated object reference is saved. BOOLEAN write-read access. 
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Example: 


The "StatusDisplayConfiguration()" procedure accesses the properties of the Status Display. 
In this example the picture assigned in the Status Display object is to be saved. 


Sub StatusDisplayConfiguration () 

"VBA502 

Dim objStatusDisplay As HMIStatusDisplay 

Set objStatusDisplay = ActiveDocument.HMIObjects.AddHMIObject ("StatusDisplayl", 
"HMIStatusDisplay") 

With objStatusDisplay 

.FlashPicReferenced = Tru 

End With 

End Sub 


See also 
StatusDisplay Object (Page 2070) 


FlashPicTransColor Property 


Description 


Defines which color of the bitmap object (.bmp, .dib) assigned to the flash picture should be 
set to "transparent". LONG write-read access. 


The color is only set to "Transparent" if the value of the "FlashPicUseTransColor" property is 
"True". 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
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Example: 


The "StatusDisplayConfiguration()" procedure accesses the properties of the Status Display. 
In this example the color "Yellow" will be set to "Transparent". 


Sub StatusDisplayConfiguration () 

"VBA503 

Dim objStatusDisplay As HMIStatusDisplay 

Set objStatusDisplay = ActiveDocument.HMIObjects.AddHMIObject ("StatusDisplayl", 
"HMIStatusDisplay") 

With objStatusDisplay 

»-FlashPicTransColor = RGB(255, 255, 0) 

.FlashPicUseTransColor = True 

End With 

End Sub 


See also 
FlashPicUseTransColor Property (Page 2246) 
StatusDisplay Object (Page 2070) 


FlashPicture Property 


Description 
Defines or returns the Flash Picture for the Status Display object. 


The picture (*.BMP or *.DIB) must be located in the "GraCS" directory of the current project 
so that it can be integrated. 


The "FlashPicReferenced" property defines in this case whether the flash picture will be saved 
with the Status Display object or referenced. 
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Example: 


The "StatusDisplayConfiguration()" procedure accesses the properties of the Status Display. 
In this example the picture "Testpicture.BMP" will be used as the flash picture: 


Sub StatusDisplayConfiguration () 

"VBA504 

Dim objStatusDisplay As HMIStatusDisplay 

Set objStatusDisplay = ActiveDocument.HMIObjects.AddHMIObject ("StatusDisplayl", 
"HMIStatusDisplay") 

With objStatusDisplay 

' 


'To use this example copy a Bitmap-Graphic 

"to the "GraCS"-Folder of the actual project. 

"Replace the picturename "Testpicture.BMP" with the name of 
"the picture you copied 

-FlashPicture = "Testpicture.BMP" 

End With 

End Sub 


See also 
FlashPicReferenced Property (Page 2242) 
StatusDisplay Object (Page 2070) 


FlashPicture property 


Description 


Specifies which flashing picture is to be displayed for the currently selected status. Pictures 
with the following formats can be inserted: EMF, WMF, BMP, GIF, JPG. 


The flash picture should have the same picture size as the basic picture, otherwise its display 
is distorted. 


FlashPictureState property 


Description 


Only used internally. 


See also 
AdvancedStateDisplay object (Page 1905) 
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FlashPicUseTransColor Property 


Description 


TRUE, when the configured color ("FlashPicTransColor" property) of the bitmap objects 
assigned to the flash picture should be set to "transparent". BOOLEAN write-read access. 


Example: 


The "StatusDisplayConfiguration()" procedure accesses the properties of the Status Display. 
In this example the color "Yellow" will be set to "Transparent": 


Sub StatusDisplayConfiguration () 

"VBA505 

Dim objStatusDisplay As HMIStatusDisplay 

Set objStatusDisplay = ActiveDocument.HMIObjects.AddHMIObject ("StatusDisplayl", 
"HMIStatusDisplay") 

With objStatusDisplay 

»-FlashPicTransColor = RGB(255, 255, 0) 

.FlashPicUseTransColor = True 

End With 

End Sub 


See also 
FlashPicTransColor Property (Page 2243) 
StatusDisplay Object (Page 2070) 


FlashRate Property 


Description 


Defines or returns the flash frequency of the "GroupDisplay", "AdvancedAnalogDisplay" and 
"AdvancedStateDisplay" objects. Value range from 0 to 2. 


Flash frequency Assigned Value 
Slow (approx. 0.25 Hz) 0 
Medium (approx. 0.5 Hz) 1 
Fast (approx. 1 Hz) 2 
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Note 


Because the flashing is performed by means of software engineering, the flash frequency is 


both system-dependent and hardware-bound (number of objects, processor speed, RAM size, 
update time, etc.). 


The information in the table is therefore only for orientation purposes. 


Example 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the flash frequency will be set to "Medium": 


Sub GroupDisplayConfiguration() 

"VBA506 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMTGroupDisplay") 

With objGroupDisplay 

-FlashRate = 1 

End With 

End Sub 


See also 


GroupDisplay Object (Page 1980) 
FlashRateBackColor Property 


Description 


Defines or returns the flash frequency for the object background. Value range from 0 to 2. 


Flash frequency Assigned Value 
Slow (approx. 0.25 Hz) 0 
Medium (approx. 0.5 Hz) 1 
Fast (approx. 1 Hz) 2 
Note 


Because the flashing is performed by means of software engineering, the flash frequency is 


both system-dependent and hardware-bound (number of objects, processor speed, RAM size, 
update time, etc.). 


The information in the table is therefore only for orientation purposes. 
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Example 


The "ButtonConfiguration()" procedure accesses the properties of the button. In this example 


the flash frequency for the background will be set to "Medium": 


Sub ButtonConfiguration() 


"VBA507 


Dim objButton As HMIButton 
Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Buttonl", "“HMIButton") 


With objButton 


.FlashRateBackColor = 1 


End Sub 


See also 


2248 


End With 


StaticText Object (Page 2067) 
Slider object (Page 2062) 

TextList Object (Page 2076) 
RoundRectangle Object (Page 2055) 
RoundButton Object (Page 2052) 
Rectangle Object (Page 2049) 
Polygon Object (Page 2035) 
PieSegment Object (Page 2032) 
OptionGroup Object (Page 2025) 
GraphicObject Object (Page 1975) 
IOField Object (Page 1992) 
EllipseSegment Object (Page 1963) 
Ellipse Object (Page 1957) 

Circle Object (Page 1928) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 
BarGraph Object (Page 1914) 
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Description 
Defines or returns the flash frequency for the lines of the object. Value range from 0 to 2. 
Flash frequency Assigned Value 
Slow (approx. 0.25 Hz) 0 
Medium (approx. 0.5 Hz) 1 
Fast (approx. 1 Hz) 2 
Note 
Because the flashing is performed by means of software engineering, the flash frequency is 
both system-dependent and hardware-bound (number of objects, processor speed, RAM size, 
update time, etc.). 
The information in the table is therefore only for orientation purposes. 
Example 


The "ButtonConfiguration()" procedure accesses the properties of the button. In this example 
the flash frequency for the border will be set to "Medium": 


Sub ButtonConfiguration() 
"VBA508 
Dim objButton As HMIButton 


Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Buttonl", 


With objButton 
-FlashRateBorderColor = 1 
End With 

End Sub 


See also 
Slider object (Page 2062) 
StatusDisplay Object (Page 2070) 
StaticText Object (Page 2067) 
TextList Object (Page 2076) 
RoundRectangle Object (Page 2055) 
RoundButton Object (Page 2052) 
Rectangle Object (Page 2049) 
PolyLine Object (Page 2038) 
Polygon Object (Page 2035) 
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PieSegment Object (Page 2032) 
OptionGroup Object (Page 2025) 
Line Object (Page 2004) 
GraphicObject Object (Page 1975) 
IOField Object (Page 1992) 
EllipseSegment Object (Page 1963) 
EllipseArc Object (Page 1960) 
Ellipse Object (Page 1957) 
CircularArc Object (Page 1931) 
Circle Object (Page 1928) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 


FlashRateFlashPic Property 


Description 


Defines or returns the flash frequency for the status display. Value range from 0 to 2. 


Flash frequency Assigned Value 
Slow (approx. 0.25 Hz) 0 

Medium (approx. 0.5 Hz) 1 

Fast (approx. 1 Hz) 2 

Note 


Because the flashing is performed by means of software engineering, the flash frequency is 
both system-dependent and hardware-bound (number of objects, processor speed, RAM size, 
update time, etc.). 


The information in the table is therefore only for orientation purposes. 
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Example 


The "GroupDisplayConfiguration()" procedure accesses the properties of the status display. 
In this example the flash frequency for the flash picture will be set to "Medium": 


Sub StatusDisplayConfiguration () 

"VBA509 

Dim objStatusDisplay As HMIStatusDisplay 

Set objStatusDisplay = ActiveDocument.HMIObjects.AddHMIObject ("StatusDisplayl", 
"HMIStatusDisplay") 

With objStatusDisplay 

.FlashRateFlashPic = 1 

End With 

End Sub 


See also 


StatusDisplay Object (Page 2070) 
FlashRateForeColor Property 


Description 


Defines or returns the flash frequency for the object label. Value range from 0 to 2. 


Flash frequency Assigned Value 
Slow (approx. 0.5 Hz) 0 
Medium (approx. 2 Hz) 1 
Fast (approx. 8 Hz) 2 
Note 


Because the flashing is performed by means of software engineering, the flash frequency is 


both system-dependent and hardware-bound (number of objects, processor speed, RAM size, 
update time, etc.). 


The information in the table is therefore only for orientation purposes. 
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Example 


The "ButtonConfiguration()" procedure accesses the properties of the button. In this example 
the flash frequency for the label will be set to "Medium": 


Sub ButtonConfiguration () 

"VBA510 

Dim objButton As HMIButton 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Buttonl", “HMIButton") 
With objButton 

.FlashRateForeColor = 1 


End With 
End Sub 
See also 
TextList Object (Page 2076) 
StaticText Object (Page 2067) 
OptionGroup Object (Page 2025) 
lOField Object (Page 1992) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 
FlashState property 
Description 
Only used internally. 
See also 
AdvancedAnalogDisplay object (Page 1901) 
Folder Property 
Description 


Returns a folder from the components library. 
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Example: 


The "ShowFolderltems()" procedure accesses the symbol libraries. In this example all the 


folder names in the global symbol library and project symbol library will be output: 


Sub ShowFolderItems () 

"'VBA511 

Dim colFolderItems As HMIFolderItems 

Dim objFolderItem As HMIFolderItem 

Dim iAnswer As Integer 

Dim iMaxFolder As Integer 

Dim iMaxSymbolLib As Integer 

Dim iSymbolLibIndex As Integer 

Dim iSubFolderIndex As Integer 

Dim strSubFolderName As String 

Dim strFolderItemName As String 

'To determine the number of symbollibraries: 
iMaxSymbolLib = Application.SymbolLibraries.Count 
iSymbolLibIndex = 1 

For iSymbolLibIndex = 1 To iMaxSymbolLib 

With Application.SymbolLibraries (iSymbolLibIndex) 
Set colFolderItems = .FolderItems 


'To determine the number of folders in actual symbollibrary: 
iMaxFolder = .FolderItems.Count 
MsgBox "Number of FolderItems in" & .Name & " : " & iMaxFolder 


"Output of all subfoldernames from actual folder: 
For Each objFolderItem In colFolderItems 
iSubFolderIndex = 1 
For iSubFolderIndex = 1 To iMaxFolder 
strFolderItemName = objFolderItem.DisplayName 
If 0 <> objFolderItem.Folder.Count Then 
strSubFolderName = objFolderItem. Folder (iSubFolderIndex) .DisplayName 
iAnswer = MsgBox("SymbolLibrary: " & .Name & vbCrLf & "act. Folder: " & 
strFolderItemName & vbCrLf & "act. Subfolder: " & strSubFolderName, vbOKCancel) 


'T£ "Cancel" is clicked, continued with next FolderItem 
If vbCancel = iAnswer Then 
Exit For 
End If 
Else 
sgBox "There are no subfolders in " & objFolderItem.DisplayName 
Exit For 
End If 
Next iSubFolderIndex 
Next objFolderItem 
End With 
Next iSymbolLibIndex 
End Sub 
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See also 
SymbolLibraries Object (Listing) (Page 2073) 
SymbolLibrary Object (Page 2074) 
Folderltems Object (Listing) (Page 1973) 
Folderltem Object (Page 1972) 
Accessing the component library with VBA (Page 1646) 
Folderltems Property 
Description 


Returns a listing containing all the folders in the symbol library. 
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Example: 


The "ShowFolderltems()" procedure accesses the symbol libraries. In this example all the 


folder names in the global symbol library and project symbol library will be output: 


Sub ShowFolderItems () 

"VBA512 

Dim colFolderItems As HMIFolderItems 

Dim objFolderItem As HMIFolderItem 

Dim iAnswer As Integer 

Dim iMaxFolder As Integer 

Dim iMaxSymbolLib As Integer 

Dim iSymbolLibIndex As Integer 

Dim iSubFolderIndex As Integer 

Dim strSubFolderName As String 

Dim strFolderItemName As String 

'To determine the number of symbollibraries: 
iMaxSymbolLib = Application.SymbolLibraries.Count 
iSymbolLibIndex = 1 

For iSymbolLibIndex = 1 To iMaxSymbolLib 

With Application.SymbolLibraries (iSymbolLibIndex) 
Set colFolderItems = .FolderItems 


'To determine the number of folders in actual symbollibrary: 
iMaxFolder = .FolderItems.Count 


MsgBox "Number of FolderItems in" & .Name & " : " & iMaxFolder 
' 


"Output of all subfoldernames from actual folder: 
For Each objFolderItem In colFolderItems 
iSubFolderIndex = 1 
For iSubFolderIndex = 1 To iMaxFolder 
strFolderItemName = objFolderItem.DisplayName 
If 0 <> objFolderItem.Folder.Count Then 
strSubFolderName = objFolderItem. Folder (iSubFolderIndex) .DisplayName 
iAnswer = MsgBox("SymbolLibrary: " & .Name & vbCrLf & "act. Folder: " & 
strFolderItemName & vbCrLf & "act. Subfolder: " & strSubFolderName, vbOKCancel) 


‘If "Cancel" is clicked, continued with next FolderItem 
If vbCancel = iAnswer Then 
Exit For 


End If 
Else 
sgBox "There are no subfolders in " & objFolderItem.DisplayName 
Exit For 


End If 

Next iSubFolderIndex 
Next objFolderItem 
End With 

Next iSymbolLibIndex 
End Sub 
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See also 
Folderltem Object (Page 1972) 
SymbolLibraries Object (Listing) (Page 2073) 
SymbolLibrary Object (Page 2074) 
Folderltems Object (Listing) (Page 1973) 
Accessing the component library with VBA (Page 1646) 


FontBold Property 


Description 


TRUE, when the text in the object should be assigned the "bold" attribute. BOOLEAN write- 
read access. 


Example: 


The "ButtonConfiguration()" procedure accesses the properties of the button. In this example 
the font attribute will be set to "Bold": 


Sub ButtonConfiguration() 

"VBA513 

Dim objButton As HMIButton 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Buttonl", “HMIButton") 
With objButton 

-FontBold = True 

End With 

End Sub 


See also 
TextList Object (Page 2076) 
StaticText Object (Page 2067) 
OptionGroup Object (Page 2025) 
IOField Object (Page 1992) 
GroupDisplay Object (Page 1980) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 
BarGraph Object (Page 1914) 
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Fontitalic Property 


Description 


TRUE, when the text in the object should be assigned the "italic" attribute. BOOLEAN write- 
read access. 


Example: 


The "ButtonConfiguration()" procedure accesses the properties of the button. In this example 
the font attribute will be set to "Italic": 


Sub ButtonConfiguration() 

"VBA514 

Dim objButton As HMIButton 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Buttonl", "“HMIButton") 
With objButton 

-FontItalic = True 

End With 

End Sub 


See also 
StaticText Object (Page 2067) 
TextList Object (Page 2076) 
OptionGroup Object (Page 2025) 
IOField Object (Page 1992) 
GroupDisplay Object (Page 1980) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 
BarGraph Object (Page 1914) 


FontName Property 
Description 


Defines or returns the font name of the text in the object. 


All the fonts installed in Windows are available for selection. 
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Example: 


The "ButtonConfiguration()" procedure accesses the properties of the button. In this example 
the font is set to Arial: 


Sub ButtonConfiguration () 

"VBA515 

Dim objButton As HMIButton 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Buttonl", “HMIButton") 
With objButton 

-FontName = "Arial" 

End With 

End Sub 


See also 
CheckBox Object (Page 1924) 
TextList Object (Page 2076) 
StaticText Object (Page 2067) 
OptionGroup Object (Page 2025) 
IOField Object (Page 1992) 
GroupDisplay Object (Page 1980) 
Button Object (Page 1921) 
BarGraph Object (Page 1914) 


FontSize Property 


Description 


Defines or returns the font size of the text in the object in points. 


Example: 


The "ButtonConfiguration()" procedure accesses the properties of the button. In this example 
the font size will be set to 10 points: 


Sub ButtonConfiguration () 

"VBA516 

Dim objButton As HMIButton 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Buttonl", "HMIButton") 
With objButton 

-FONTSIZE = 10 

End With 

End Sub 
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See also 
TextList Object (Page 2076) 
StaticText Object (Page 2067) 
OptionGroup Object (Page 2025) 
IOField Object (Page 1992) 
GroupDisplay Object (Page 1980) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 
BarGraph Object (Page 1914) 


FontUnderline Property 


Description 


3.6 VBA Reference 


TRUE, when the text in the object should be assigned the "underline" attribute. BOOLEAN 


write-read access. 


Example: 


The "ButtonConfiguration()" procedure accesses the properties of the button. In this example 


the font attribute will be set to "Underline": 


Sub ButtonConfiguration() 

"VBA517 

Dim objButton As HMIButton 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Buttonl", 
With objButton 

-FontUnderline = True 

End With 

End Sub 


See also 
TextList Object (Page 2076) 
StaticText Object (Page 2067) 
OptionGroup Object (Page 2025) 
IOField Object (Page 1992) 
GroupDisplay Object (Page 1980) 
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CheckBox Object (Page 1924) 
Button Object (Page 1921) 
BarGraph Object (Page 1914) 


ForeColor Property 


Description 


Defines or returns the color of the font for the text in the object. LONG write-read access. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


Example: 


The "ButtonConfiguration()" procedure accesses the properties of the button. In this example 
the font color will be set to "Red": 


Sub ButtonConfiguration() 

"VBA518 

Dim objButton As HMIButton 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Buttonl", "“HMIButton") 
With objButton 

-ForeColor = RGB(255, 0, O) 

End With 

End Sub 


See also 
Button Object (Page 1921) 
TextList Object (Page 2076) 
StaticText Object (Page 2067) 
OptionGroup Object (Page 2025) 
IOField Object (Page 1992) 
GroupDisplay Object (Page 1980) 
CheckBox Object (Page 1924) 
BarGraph Object (Page 1914) 
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ForeColor_Alarm.._Warning property 


Description 
Defines the color used for the foreground of one of the following states or message types: 
e Alarm 
e Warning 
e Tolerance 
e AS Process Control Error 
e AS Control System Fault 
e Operator request 
e OK 


e Simulation 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


ForeFlashColorOff Property 


Description 


Defines or returns the color of the text for flash status "Off". LONG write-read access. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
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Example: 


The "ButtonConfiguration()" procedure accesses the properties of the button. In this example 
the font color when the flash status is "Off" will be set to "Red": 


Sub ButtonConfiguration () 

"VBA519 

Dim objButton As HMIButton 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Buttonl", “HMIButton") 
With objButton 

-ForeFlashColorOff = RGB(255, 0, O) 

End With 

End Sub 


See also 
CheckBox Object (Page 1924) 
TextList Object (Page 2076) 
StaticText Object (Page 2067) 
OptionGroup Object (Page 2025) 
IOField Object (Page 1992) 
GroupDisplay Object (Page 1980) 
Button Object (Page 1921) 
BarGraph Object (Page 1914) 


ForeFlashColorOn Property 


Description 


Defines or returns the color of the text for flash status "On". LONG write-read access. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
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Example: 


The "ButtonConfiguration()" procedure accesses the properties of the button. In this example 
the font color when the flash status is "On" will be set to "White": 


Sub ButtonConfiguration() 

"VBA520 

Dim objButton As HMIButton 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Buttonl", “HMIButton") 
With objButton 

.ForeFlashColorOn = RGB(255, 255, 255) 


End With 
End Sub 
See also 
TextList Object (Page 2076) 
StaticText Object (Page 2067) 
OptionGroup Object (Page 2025) 
IOField Object (Page 1992) 
GroupDisplay Object (Page 1980) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 
BarGraph Object (Page 1914) 
Format property 
Description 
Specifies the format in which the value is displayed in the advanced analog display. 
No Character Displays the number without formatting. 
(0) Displays a digit or a zero. 
(#) Displays a digit or no output. 
(.) Placeholder for decimal character. 
(%) Placeholder for percentage. 
(,) Thousand separator. 
(( E- E+ e- e+ ) Scientific format. 
-+$() Display of a literal character. 
(*) Display the next character in the format character sequence. 
( "ABC" ) Displays the string in inverted commas (""). 
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G-H 

GlobalColorScheme property 

Description 
Defines whether the colors defined for the current design in the global color scheme will be 
used for this object. 
yes Uses the colors from the global color scheme defined for this type of object. 
No Uses the colors from the color scheme defined for this type of object under 

"Colors". 

Example 

GlobalShadow property 

Description 
Defines whether the object will be displayed with the shadowing defined in the active design. 
yes Uses the global shadowing defined for this object type. 
No No shadowing. 

Example 


GNQBackColorOff..ColorOn property 


Description 


2264 


Specifies for the selected message type and the state "Went Out Unacknowledged" which 
color the background of the value to be displayed assumes for flashing status "Off" 
(GNQBackColorOff) or "On" (GNQBackColorOn). 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0). 
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GNQBackFlash property 


Description 


Specifies for the selected message type and status "Went Out Unacknowledged" whether the 
background of the value to be displayed flashes when a message goes out unacknowledged. 


GNQTextColorOff..ColorOn property 


Description 
Specifies for the selected message type and the state "Went Out Unacknowledged" which 
color the text of the value to be displayed assumes for flashing status "Off" (GNQTextColorOff) 
or "On" (GNQTextColorOn). 
Determination of Color Value 
The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0). 

GNQTextFlash property 

Description 
Specifies for the selected message type and status "Went Out Unacknowledged" whether the 
text of the value to be displayed flashes when a message goes out unacknowledged. 

Grid Property 

Description 
TRUE if the grid is enabled for the active picture. BOOLEAN write-read access. 
The grid is only visible during the configuration phase. 

Example: 


The "ActiveDocumentConfiguration()" procedure accesses the properties of the current picture 
in the Graphics Designer. In this example the grid for the active picture will be enabled: 


Sub ActiveDocumentConfiguration() 
"VBA521 
Application.ActiveDocument.Grid = True 
End Sub 
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See also 
GridWidth Property (Page 2267) 
GridHeight Property (Page 2267) 
GridColor Property (Page 2266) 
ActiveDocument Property (Page 2107) 
Application Property (Page 2121) 
Document Object (Page 1949) 
Application Object (Page 1909) 


GridColor Property 


Description 


Defines or returns the color of the grid during the configuration phase. The Grid property must 
be set to TRUE for the grid to be displayed. LONG write-read access. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


Example: 


The "ActiveDocumentConfiguration()" procedure accesses the properties of the current picture 
in the Graphics Designer. In this example the grid color for the active picture will be set to 
"Blue": 


Sub ActiveDocumentConfiguration() 

"VBA522 

Application.ActiveDocument.Grid = True 
Application.ActiveDocument.GridColor = RGB(0, 0, 255) 
End Sub 


See also 
Grid Property (Page 2265) 
ActiveDocument Property (Page 2107) 
Application Property (Page 2121) 
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Document Object (Page 1949) 
Application Object (Page 1909) 


GridHeight Property 


Description 


3.6 VBA Reference 


Defines or returns the height (in pixels) of the grid in the current picture during the configuration 
phase. The Grid property must be set to TRUE for the grid to be displayed. 


Example: 


The "ActiveDocumentConfiguration()" procedure accesses the properties of the current picture 
in the Graphics Designer. In this example the grid height for the active picture will be set to 


now. 


Sub ActiveDocumentConfiguration() 

"VBA523 

Application.ActiveDocument.Grid = True 
Application.ActiveDocument.GridHeight = 8 
End Sub 


See also 
GridWidth Property (Page 2267) 
Grid Property (Page 2265) 
ActiveDocument Property (Page 2107) 
Application Property (Page 2121) 
Document Object (Page 1949) 
Application Object (Page 1909) 


GridWidth Property 


Description 


Defines or returns the width (in pixels) of the grid in the current picture during the configuration 
phase. The Grid property must be set to TRUE for the grid to be displayed. 
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Example: 


The "ActiveDocumentConfiguration()" procedure accesses the properties of the current picture 
in the Graphics Designer. In this example the grid width for the active picture will be set to "8": 


Sub ActiveDocumentConfiguration() 
"VBA524 

Application.ActiveDocument.Grid = True 
Application.ActiveDocument.GridWidth = 8 


End Sub 
See also 
Grid Property (Page 2265) 
GridHeight Property (Page 2267) 
ActiveDocument Property (Page 2107) 
Application Property (Page 2121) 
Document Object (Page 1949) 
Application Object (Page 1909) 
GroupParent Property 
Description 
Returns the higher-ranking object in the specified group object. Read-only access. 
Example: 
See also 


Group Object (Page 1978) 

ActiveDocument Property (Page 2107) 
GroupedObjects Object (Listing) (Page 1983) 
Document Object (Page 1949) 

Application Object (Page 1909) 
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GroupedHMlObjects Property 


Description 


Returns a listing containing all the objects in the current group. 


Example: 


In this example the group object "Group1" is created from a number of objects. An ellipse 
segment is then added to the group object: 


Sub CreateGroup () 

"VBA526 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 

Dim objEllipseSegment As HMIE1]llipseSegment 
Dim objGroup As HMIGroup 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SsRectangle", "HMIRectangle") 
With objCircle 

-Top = 40 

-Left = 40 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 80 

-Selected = Tru 

End With 


sgBox "Objects selected!" 

Set objGroup = ActiveDocument.Selection.CreateGroup 

objGroup.ObjectName = "Groupl" 

Set objEllipseSegment = ActiveDocument.HMIObjects.AddHMIObject ("EllipseSegment", 
"HMIELlLipseSegment") 


"Add one object to the existing group 
objGroup.GroupedHMIObjects.Add ("EllipseSegment") 
End Sub 


See also 
Group Object (Page 1978) 


Height Property 


Description 


Defines or returns the height of the object (Document, View, Object) in pixels. 
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Note concerning the Document and View objects: 


The default value corresponds to the vertical screen resolution set by the operating system. 
The specified value can be higher than the current screen resolution. The picture can then be 
moved with the aid of scroll bars. 


The maximum picture height that can be set is 10000 pixels. 


Example: 


The "ActiveDocumentConfiguration()" procedure accesses the properties of the current picture 
in the Graphics Designer. In this example the height of the current picture will be set to "1600": 


Sub ActiveDocumentConfiguration() 


"VBA527 
Application.ActiveDocument.Height = 1600 
End Sub 
See also 
View Object (Page 2102) 
HMIObject Object (Page 1988) 
Document Object (Page 1949) 
Hide Property 
Description 


TRUE if the specified picture is opened as "Visible". BOOLEAN write-read access. 


Use the Hide property in order to test, for example, whether a picture is to be visible or invisible 
when opened. Other WinCC editors (such as CrossReference) open pictures so that they are 
invisible, i.e. they are not displayed in the Graphics Designer. If you use the DocumentOpened 
event, for example, you can use the Hide property to prevent the code in the event from being 
executed by testing that the Hide property is FALSE. 


Use the Add and Open methods to define whether a picture is to be visible or invisible when 
opened. 


Note 


If you set a picture to "Invisible" (Hide = FALSE), you can then only address it via the 
Documents listing. The picture is no longer available in the Graphics Designer. 
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Example: 


In the following example, when a picture opens an output indicates whether the picture was 
opened as visible or invisible: 


Private Sub Document _Opened(CancelForwarding As Boolean) 
"VBA802 

sgBox Me.Hide 

End Sub 


See also 
Open Method (Page 1867) 
Add Method (Documents Listing) (Page 1790) 
Document Object (Page 1949) 


HiddenInput Property 


Description 


TRUE, when the input value should not be displayed when being entered. Each character 
entered is substituted by a *. BOOLEAN write-read access. 


Example: 


The "lOFieldConfiguration()" procedure accesses the properties of the I/O field. In this example 
the input will be hidden: 


Sub IOFieldConfiguration () 

"VBA528 

Dim objIOField As HMIIOField 

Set obj1IOField = ActiveDocument.HMIObjects.AddHMIObject ("IOField1l", "HMIIOField") 
With objIOField 

-HiddenInput = True 

End With 

End Sub 


See also 
lOField Object (Page 1992) 
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HMlObjects Property 


Description 
Returns a listing containing all the objects in the specified picture. 


To return an element from the HMlObjects listing you can use either the index number or the 
object name. 


Example: 


Use the "AddHMlObject(ObjectName, ProgID)" method to insert a new object in a picture: : 


Sub AddCircle() 


"VBA529 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("my Circle", "HMICircle") 
End Sub 
See also 


Document Object (Page 1949) 


HMIUdoObjects property 


Description 
Supplies a collection of HMlObject objects that represent the inner objects of the 
"CustomizedObjects" object. 
See also 
CustomizedObject Object (Page 1938) 
Hotkey Property 
Description 
Defines or returns the function key for a mouse action in the case of the Button object. 
Function key Assigned Value 
F1 112 
F2 113 
F3 114 
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Function key Assigned Value 
F4 115 
F5 116 
F6 117 
F7 118 
F8 119 
FQ 120 
F10 121 
| 122 
F12 123 


Example: 


The "ButtonConfiguration()" procedure accesses the properties of the button. In this example 
it is intended that the button can also be launched with function key "F5": 


Sub ButtonConfiguration() 


"VBA530 
Dim objButton As HMIButton 
Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Buttonl", "HMIButton") 


With objButton 
-Hotkey = 116 
End With 

End Sub 


See also 
Button Object (Page 1921) 


Hysteresis Property 


Description 


TRUE if the display must include hysteresis (deadband) in the case of the BarGraph object. 
BOOLEAN write-read access. 
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Example: 


The "BarGraphConfiguration()" procedure configures In this example the display shall take 
place with hysteresis: 


Sub BarGraphConfiguration () 

'VBA531 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument .HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

-Hysteresis = True 

End With 

End Sub 


See also 
BarGraph Object (Page 1914) 


HysteresisRange Property 


Description 
Defines or returns the hysteresis (deadband) as a percentage of the display value. 


The Hysteresis property must be set to TRUE for the hysteresis to be calculated. 


Example: 


The "BarGraphConfiguration()" procedure configures In this example the hysteresis will be set 
to "4%": 


Sub BarGraphConfiguration() 

"VBA532 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 


-Hysteresis = True 
.HysteresisRange = 4 
End With 

End Sub 

See also 


BarGraph Object (Page 1914) 
Hysteresis Property (Page 2273) 
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I-K 
Icon Property 
Description 
Defines the icon (*.ICO, full path and file name) or returns the path and file name for a button 
on a user-defined toolbar. 
Path specifications 
The following path specification formats are possible: 
e Absolute: z.B. "C:\Siemens\WinCC\lcons\mylcon.ICO. 
e@ Relative: The starting folder for relative path specification is the "GraCS" folder of the current 
project. 
@ <global>: Refers to the installation path for WinCC. The path specification "<global>\lcons 
\mylcon" is the same as the path specification under "Absolute". 
e@ <project>: Refers to the current project directory (see example). 
Example: 
The "CreateToolbar()" procedure creates a user-defined toolbar with two icons: 
Sub CreateToolbar () 


"VBA533 
Dim objToo 


a 


Dim objToo 


lbar As HMIToolbar 
lbarItem As HMIToolbarItem 


Dim strFileWithPath 


Set objToo 
Set objToo 


Set objToo 


lbar = ActiveDocument.CustomToolbars.Add("Tooll 1") 
lbarItem = objToolbar.ToolbarItems.InsertToolbarItem(1, "til 1", 
"myFirstToolbaritem") 


lbarItem = objToolbar.ToolbarItems.InsertToolbarItem(2, "til 2", 


"mySecondToolbaritem") 


'To use this example copy a *.ICO-Graphic 
"to the "GraCS"-Folder of the actual project. 


"Replace the filename "EZSTART.ICO" in the next commandline 
‘with the name of the ICO-Graphic you copied 
strFileWithPath = Application.ApplicationDataPath & "EZSTART.ICO" 


' 
'To assign 


objToolbar 
End Sub 


the symbol-icon to the first toolbaritem 
-ToolbarItems(1).Icon = strFileWithPath 
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See also 


Toolbarltems Object (Listing) (Page 2085) 

Toolbarltem Object (Page 2083) 

How to Add a New Icon to the Toolbar (Page 1637) 

How to Create an Application-specific Toolbar (Page 1635) 


IndependentWindow property 


Description 


Index Property 


Description 


2276 


Defines whether the display of the picture window in Runtime depends on the process picture 
in which the picture window was configured. 


yes Size and position of the picture window are independent of the process picture 
and only defined by the "Window mode" attribute 
No Size and position of the picture window change with the shift or scaling of the 


process picture 


Status display 

Defines the status (0 bis 255) or returns it. A basic picture and flash picture can be defined for 
each status value. 

Line Object 

Defines the start and end point for a line, and so also defines the direction. Use the 
ActualPointLeft and ActualPointTop properties to define the coordinates for each starting and 
finishing point. 

Polygon object, PolyLine object and TubePolyline object 

Defines or returns the number of the corner point whose position coordinates you want to 
change or display. 

CheckBox and OptionGroup objects 

Defines or returns the number (1 to 32) of the field whose text is to be defined. 


ComboBox and ListBox object 
Defines or returns the number (1 to 32) of the line whose text is to be defined. 
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Example 1: Line 


In the following example a line will be inserted into the active picture and the starting and 
finishing points will be defined: 


Sub LineAdd () 

"VBA682 

Dim objLine As HMILine 

Dim objEvent As HMIEvent 

Set objLine = ActiveDocument.HMIObjects.AddHMIObject ("myLine", "HMILine") 
With objLine 

-BorderColor = RGB(255, 0, 0) 

-index = hmiLineIndexTypeStartPoint 

-ActualPointLeft = 12 
-ActualPointTop = 34 
-index = hmiLineIndexTypeEndPoint 
-ActualPointLeft = 74 
-ActualPointTop = 64 

End With 

End Sub 


Example 2: Polyline 


For this example to work, insert a polyline called "Polyline1" into the active picture: The 
"PolyLineCoordsOutput" procedure then outputs the coordinates of all the corner points in the 
polyline: 


Sub PolyLineCoordsOutput () 

"VBA534 

Dim iPcIndex As Integer 

Dim iPosX As Integer 

Dim iPosY As Integer 

Dim iIndex As Integer 

Dim objPolyLine As HMIPolyLine 

Set objPolyLine = Application.ActiveDocument .HMIObjects.AddHMIObject ("PolyLinel", 
"HMIPolyLine") 


"Determine number of corners from "PolyLinel": 
iPcIndex = objPolyLine.PointCount 

' 

‘Output of x/y-coordinates from every corner: 
For iIndex = 1 To iPcIndex 

With objPolyLine 

-index = iIndex 

iPosX = .ActualPointLeft 

iPosY = .ActualPointTop 

sgBox iIndex & ". corner:" & vbCrLf & "x-coordinate: " & iPosX & vbCrLf & "y-coordinate: 
" & iPosYy 

End With 

Next iIndex 

End Sub 
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Example 3: Check box 


The "CreateOptionGroup()" procedure creates the OptionGroup object with four option 
buttons. Each option button is assigned the default name "myCustomText<Nummer>": 


Sub CreateOptionGroup () 

"VBA535 

Dim objRadioBox As HMIOptionGroup 
Dim iIndex As Integer 

Set objRadioBox = ActiveDocument.HMIObjects.AddHMIObject ("RadioBox 1", "HMIOptionGroup") 
With objRadioBox 

-Height = 100 

-Width = 180 

-BoxCount = 4 

For iIndex = 1 To .BoxCount 
-index = iIndex 

-Text = "myCustomText" & .index 
ext iIndex 

End With 

End Sub 


See also 
Line Object (Page 2004) 
FlashPicture Property (Page 2244) 
BasePicture Property (Page 2144) 
ActualPointTop Property (Page 2110) 
ActualPointLeft Property (Page 2109) 
StatusDisplay Object (Page 2070) 
PolyLine Object (Page 2038) 
Polygon Object (Page 2035) 
OptionGroup Object (Page 2025) 


InheritState property 


Description 


Defines whether the "Display" and "Operator Control Enable" properties of the user object can 
be inherited by the individual objects of the user object. 
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Description 
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Defines the value to be entered by the user in the I/O field. The value is not displayed in the |/ 


O field when the property is set. 


If you want the value to be displayed in the I/O field after confirmation with the <Return> key, 
configure a direct connection between the properties "input value" and "output value". The 
direct connection is only practical when no tag is connected to the output value, but the user 
can nevertheless query the specified value, for example, through a script. 


Example: 


IsActive Property 


Description 


Returns TRUE if a copy of the current picture is active. BOOLEAN read access. 


Example: 


The "ActiveDocumentConfiguration()" procedure accesses the properties of the current picture 
in the Graphics Designer. In this example a copy of the current picture will be created and an 


output will indicate whether the copy is active. 


Sub ActiveDocumentConfiguration() 

"VBA537 

Application. ActiveDocument.Views.Add 

‘If you comment out the following line 

"and recall the procedure, the output of 
‘the messagebox is different 
Application.ActiveDocument.Views (1) .Activate 
' 


"Output state of copy: 


sgBox Application.ActiveDocument.Views (1) .IsActive 
End Sub 
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See also 
ActiveDocument Property (Page 2107) 
View Object (Page 2102) 


IsConnectedToProject Property 


Description 


Returns TRUE if the project connection is available. BOOLEAN read access. 


Example: 


The "ConnectCheck()" procedure checks whether a project connection exists and outputs the 
result: 


Sub ConnectCheck () 

"VBA538 

Dim bCheck As Boolean 

Dim strStatus As String 

bCheck = Application.IsConnectedToProject 
If bCheck = True Then 

strStatus = "yes" 

Else 

strStatus = "no" 

End If 

sgBox "Connection to project available: " & strStatus 
End Sub 


See also 
Application Object (Page 1909) 


IsDynamicable Property 


Description 
TRUE if a property can be made dynamic. BOOLEAN read access. 
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Example: 


The HMlObjectPropertyChanged event always occurs when you change an object property in 
the Graphics Designer. In this example the property name and value will be output. A check 
will also be made on whether the property can be made dynamic: 


Sub Document _HMIObjectPropertyChanged (ByVal Property As IHMIProperty, CancelForwarding As 
Boolean) 


"VBA539 

Dim objProp As HMIProperty 
Dim strStatus As String 
Set objProp = Property 


"Checks whether property is dynamicable 

If objProp.IsDynamicable = True Then 

strStatus = "yes" 

Else 

strStatus = "no" 

End If 

sgBox "Property: " & objProp.Name & vbCrLf & "Value: " & objProp.value & vbCrLf & 
"Dynamicable: " & strStatus 

End Sub 


Further information on the "Events" topic can be found under the heading "Executing VBA 
macros in Graphics Designer". 


See also 
Property Object (Page 2042) 
HM|Object Object (Page 1988) 
HM|ObjectPropertyChanged Event (Page 1770) 
Executing VBA Macros in Graphics Designer (Page 1619) 


IsPublished property 


Description 


Only used internally. 


See also 
FaceplateProperty object (Page 1971) 
Property Object (Page 2042) 
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Italic Property 

Description 
TRUE if the font attribute "Italic" is set for the language-dependent text in the object. BOOLEAN 
write-read access. 

Example: 


The following example sets the font attributes of a button for French and English: 


Sub ExampleForLanguageFonts () 

"VBA540 

Dim objLangFonts As HMILanguageFonts 

Dim objButton As HMIButton 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMTButton") 
objButton.Text = "Hello" 

Set objLangFonts = objButton.LDFonts 


'To make fontsettings for french: 
With objLangFonts.ItemByLCID (1036) 
-Family = "Courier New" 

-Bold = True 

-Italic = False 

-Underlined = Tru 

-Size = 12 

End With 


’ 


'To make fontsettings for english: 
With objLangFonts.ItemByLCID (1033) 
-Family = "Times New Roman" 

-Bold = False 

-Italic = True 

.Underlined = Fals 

-Size = 14 

End With 

End Sub 


See also 
Underlined Property (Page 2460) 
Size Property (Page 2419) 
Parent Property (Page 2359) 
LanguagelD Property (Page 2289) 
Family Property (Page 2229) 
Bold Property (Page 2151) 
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Application Property (Page 2121) 
LanguageFont Object (Page 1996) 


Item Property 

Description 
Returns an element from a listing. Depending on the specified object, you can use either the 
index number or the name to return a particular element. 

Example: 


This example shows both kinds of indexing. In order for the example to work, create a group 
object ("Group1") with two objects. The example outputs the height of the second object in a 
group: 


Sub GetHeight () 
'VBA541 
Dim objGroup As HMIGroup 


"Next line uses the property "Item" to get a group by name 

Set objGroup = ActiveDocument.HMIObjects.Item("Group1") 

‘Otherwise next line uses index to identify a groupobject 

sgBox "The height of object 2 is: " & objGroup.GroupedHMIObjects.Item(2) .Height 
End Sub 


See also 
VariableTriggers Object (Listing) (Page 2101) 
VariableStateValues Object (Listing) (Page 2097) 
AnalogResultInfos Object (Listing) (Page 1908) 


ItemBorderBackColor Property 


Description 


Defines or returns the background color of the separation lines in the selection list for the 
TextList object. LONG write-read access. 


The background color is only visible with the property setting ItemBorderStyle > 0. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
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Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


Example: 


The "TextListConfiguration()" procedure accesses the properties of the object TextList. In this 
example the background color for the separation lines will be set to "Red": 


Sub TextListConfiguration() 

"VBA542 

Dim objTextList As HMITextList 

Set objTextList = ActiveDocument.HMIObjects.AddHMIObject ("myTextList", "HMITextList") 
With objTextList 


-ItemBorderStyle = 1 
.ItemBorderBackColor = RGB(255, 0, O) 
End With 

End Sub 

See also 


ItemBorderStyle Property (Page 2285) 
TextList Object (Page 2076) 


ltemBorderColor Property 


Description 
Defines or returns the color of the separation lines in the selection list for the TextList object. 
LONG write-read access. 
Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
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Example: 


The "TextListConfiguration()" procedure accesses the properties of the object TextList. In this 
example the color for the separation lines will be set to "White": 


Sub TextListConfiguration () 

"VBA543 

Dim objTextList As HMITextList 

Set objTextList = ActiveDocument.HMIObjects.AddHMIObject ("myTextList", "HMITextList") 
With objTextList 


-ItemBorderStyle = 1 

.-ItemBorderColor = RGB(255, 255, 255) 
End With 

End Sub 

See also 


TextList Object (Page 2076) 


ltemBorderStyle Property 
Description 
Defines or returns the dividing line style in the selection list for the TextList object. Value range 
from 0 to 4. 
Line style Assigned Value 
0 
<i 1 
eyeets 2 
ratios 3 
Be eat 4 
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Example: 


The "TextListConfiguration()" procedure accesses the properties of the object TextList. In this 
example the dividing line style will be set to "1": 


Sub TextListConfiguration () 


"VBA544 
Dim obj] 
Set objTextList 
With objTextLis 


n 


extList As HMITextList 


= ActiveDocument.HMIObjects.AddHMIObject ("myTextList", "HMITextList") 
t 
=1 


.ItemBorderStyl 


.ItemBorderBackColor = RGB(255, 0, O) 


End With 
End Sub 


See also 


ItemBorderWidth 


Description 


Example: 


2286 


TextList Object (Page 2076) 


Property 


Defines or returns the weight in pixels of the dividing lines in the selection list for the TextList 
object. 


The "TextListConfiguration()" procedure accesses the properties of the object TextList. In this 
example the dividing line width will be set to "4": 


Gp 


"Sub E 628 TextListConfiguration () 


Sub E 629 TextListConfiguration () 
"VBA545 


Dim objTextList As HMITextList 


Set objTextList = 
ActiveDocument.HMIObjects.AddHMIObject ("myTextList", "HMITextList") 


With objTextList 
.ItemBorderWidth = 4 


End With 


End Sub 
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See also 
TextList Object (Page 2076) 

Key Property 

Description 
Returns the name that identifies the entry (menu point or icon) in the user-defined menu or 
user-defined toolbar. Read only access. 
Use the Key property to determine which entry was clicked. For this purpose you can use, say, 
the events "MenultemClicked" and "ToolBarltemClicked". 

Example: 


The "CreateMenultem()" procedure creates the "Delete Objects" menu and adds two menu 
entries ("Delete Rectangles" and "Delete Circles"): 


Sub CreateMenulItem () 

"VBA546 

Dim objMenu As HMIMenu 

Dim objMenuItem As HMIMenuItem 
' 
"Add new menu "Delete objects" to menubar: 


Set objMenu = ActiveDocument.CustomMenus.InsertMenu(1, "DeleteObjects", "Delete objects") 
' 


"Adds two menuitems to menu "Delete objects" 

Set objMenuItem = objMenu.Menultems.InsertMenuItem(1, "DeleteAllRectangles", "Delet 
Rectangles") 

Set objMenulItem = objMenu.MenuItems.InsertMenuItem(2, "DeleteAllCircles", "Delete Circles") 
End Sub 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 2287 


VBA for Automated Configuration 
3.6 VBA Reference 


In connection with the "MenultemClicked" event, you can connect the menu entries with 
procedure calls, for instance. In this example the names of the menu entries will be output: 


Sub Document MenuItemClicked (ByVal MenuItem As IHMIMenuItem) 
"VBA547 

Dim strClicked As String 

Dim objMenuItem As HMIMenuItem 

Set objMenuItem = MenuItem 


'strClicked can get two values: 
"(1) "DeleteAllRectangles" and 
'(2) “DeleteAllCircles" 
strClicked = objMenulItem.Key 


"To analyse "strClicked" with "Select Case" 
Select Case strClicked 
Case "DeleteAllRectangles" 


"Instead of "MsgBox" a procedurecall (e.g. "Call <Prozedurname>") can stay here 
sgBox "'Delete rectangle’ was clicked" 

Case "DeleteAllCircles" 

sgBox "'Delete Circles' was clicked" 


End Select 

End Sub 

See also 
Toolbarltem Object (Page 2083) 
Menultem Object (Page 2013) 
InsertToolbarltem Method (Page 1856) 
InsertMenultem Method (Page 1852) 
ToolbarltemClicked Event (Page 1782) 
MenultemClicked Event (Page 1775) 
Creating Customized Menus and Toolbars (Page 1627) 

L 


Label Property 


Description 


Returns the label of the user-defined menu or menu entry in the currently set language. Read 
only access. 
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Example: 
The "CreateMenultem()" procedure creates the 


entries ("Delete Rectangles" and "Delete Circles' 


Sub CreateMenulItem () 

"VBA548 

Dim objMenu As HMIMenu 

Dim objMenuItem As HMIMenulItem 

Dim iIndex As Integer 

iIndex = 1 

1 

"Add new menu "Delete objects" to menubar 


Set objMenu = ActiveDocument.CustomMenus.InsertMenu (1, 
' 


‘Adds two menuitems to menu "Delete objects" 

Set objMenuItem = objMenu.MenulItems.InsertMenultem(1, 
rectangles") 

Set objMenultem = objMenu.MenuItems.InsertMenuItem (2, 
sgBox ActiveDocument.CustomMenus (1) .Label 

For iIndex = 1 To objMenu.Menultems.Count 

sgBox objMenu.MenulItems (iIndex) .Label 

ext iIndex 


End Sub 
See also 
CustomMenus Property (Page 2207) 
Menultems Object (Listing) (Page 2015) 
Menultem Object (Page 2013) 
Menu Object (Page 2009) 
LanguagelD Property 
Description 


3.6 VBA Reference 


"Delete Objects" menu and adds two menu 


'): In this example the labels will then be output: 


"DeleteObjects", "Delete objects") 


"DeleteAllRectangles", "Delet 


"DeleteAllCircles", "Delete circles") 


Returns the language identifier of the project language as a decimal value. LONG read access 
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Example: 


The "DataLanguages()" procedure outputs the project languages together with their language 


identifiers: 


Sub DataLanguages () 

"VBA549 

Dim colDataLang As HMIDataLanguages 
Dim objDataLang As HMIDataLanguage 
Dim nLangID As Long 
Dim strLangName As String 

Dim iAnswer As Integer 

Set colDataLang = Application.AvailableDataLanguages 
For Each objDataLang In colDataLang 

nLangID = objDataLang.LanguageID 


strLangName = objDataLang.LanguageName 
iAnswer = MsgBox(nLangID & " " & strLangName, vbOKCancel) 
If vbCancel = iAnswer Then Exit For 
ext objDataLang 
End Sub 
See also 


DataLanguages Object (Listing) (Page 1942) 
DataLanguage Object (Page 1941) 


LanguageName Property 


Description 


Returns the project language. STRING read access. 
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3.6 VBA Reference 


The "DataLanguages()" procedure outputs the project languages together with their language 


identifiers: 


Sub DataLanguages () 


"VBA550 
Dim col 
Dim obj 
Dim nha 
Dim str 
Dim iAn 
Set col 
For Eac 
nLangID 


ngID 
Lang 
swer 


As Long 
ame As String 
As Integer 


DataLang As HMIDataLanguages 
DataLang As HMIDataLanguage 


DataLang = Application.AvailableDataLanguages 
h objDataLang In colDataLang 


= objDataLang. LanguageID 


strLangName = objDataLang. LanguageName 
= MsgBox(nLangID & " " & strLangName, vbOKCancel) 
If vbCancel = iAnswer Then 


iAnswer 


End Sub 


See also 


ext objDataLang 


DataLanguag 
DataLanguag 


LanguageSwitch Property 


Description 


Exit For 


es Object (Listing) (Page 1942) 
e Object (Page 1941) 


Defines where the language-dependent assignment texts are stored or returns the value. 
BOOLEAN write-read access. 


TRUE, when the texts in the Text Library are managed. Translation to other language occurs 
in the Text Library. 


FALSE, when the texts are managed directly in the object. Translation to other language can 
be carried out using Text Distributor. 
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Example: 


The "TextListConfiguration()" procedure accesses the properties of the object TextList. In this 
example the texts will be managed in the Text Library: 


Sub TextListConfiguration () 
"VBA551 
Dim objTextList As HMITextList 


Set objTextList = ActiveDocument.HMIObjects.AddHMIObject ("myTextList", "HMITextList") 
With objTextList 
.LanguageSwitch = True 


End With 
End Sub 
See also 
TextList Object (Page 2076) 
LastChange Property 
Description 
Returns the date on which the current picture was last changed. READ access. 
xi 
Last changing: 10.01.2003 
Example: 


The "ActiveDocumentConfiguration()" procedure accesses the properties of the current picture 


in the Graphics Designer. In this example the date of the last change to the current picture will 
be output: 


Sub ActiveDocumentConfiguration() 

"VBA552 

Dim varLastDocChange As Variant 

varLastDocChange = Application.ActiveDocument.LastChange 
MsgBox "Last changing: " & varLastDocChange 

End Sub 
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See also 
Document Object (Page 1949) 

Layer Property 

Description 
Defines which layer of the picture an object is located in, or returns that information. There is 
a total of 32 layers available, whereby Layer "0" is the bottom layer and Layer "31" the top 
layer. 
The configured objects are initially in the background of a layer. 
Note 
In VBA the numbering starts at "1". An entry of "objRectangle.Layer = 1" is therefore located 
in the lowest layer. 

Example: 


The "RectangleConfiguration()" procedure accesses the properties of the rectangle. In this 
example the Rectangle object will be inserted in layer "4": 


Sub RectangleConfiguration () 

"VBA553 

Dim objRectangle As HMIRectangle 

Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 
With objRectangle 

-Layer = 4 

End With 

End Sub 


See also 
HMIObject Object (Page 1988) 
Editing Layers with VBA (Page 1657) 


Layer00..10Checked property 


Description 


TRUE if the respective limit "O" to "10" is monitored in the case of the "3DBarGraph" object. 
BOOLEAN write-read access. 
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3.6 VBA Reference 


Example 


The limit and the color representation are specified with the properties "Layer00..10Value" and 
"Layer00..10Color". 


The bar fill color and the fill pattern are specified with the properties "Layer00..10FillColor" and 
"Layer00..10FillStyle". 


The "HMI3DBarGraphConfiguration()" procedure accesses the properties of the 3DBarGraph 
object. In this example, limit "0" is to be monitored: 


Sub HMI3DBarGraphConfiguration () 


"VBA554 


Dim obj3DBar As HMI3DBarGraph 
Set obj3DBar = ActiveDocument.HMIObjects.AddHMIObject ("3DBar1", "HMI3DBarGraph") 


With obj3DBar 


.LayerO00Checked = Tru 


End With 
End Sub 


See also 


Layer00..10Value property (Page 2296) 
Layer00..10Color property (Page 2294) 
3DBarGraph Object (Page 1894) 


Layer00..10Color property 


Description 


2294 


Defines or returns the color for the respective limit "0" to "10" of the "3DBarGraph" object. 
LONG write-read access. 


When monitoring of the limit value is activated using the "Layer00..10Checked" property, the 
bar turns to the color defined by this attribute on reaching the limit value. 
Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0). 
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Example 


3.6 VBA Reference 


The "HMI3DBarGraphConfiguration()" procedure accesses the properties of the 3DBarGraph 
object. In this example the color for limit "O" is defined as "Magenta": 


Sub HMI3DBarGraphConfiguration () 


"VBA555 


Dim obj3DBar As HMI3DBarGraph 
Set obj3DBar = ActiveDocument.HMIObjects.AddHMIObject ("3DBar1", "HMI3DBarGraph") 


With obj3DBar 


dad = Tru 


. Layer00Check 
.LayerO00Color 
End With 

End Sub 


See also 


= RGB(255, 0, 255) 


Layer00..10Checked property (Page 2293) 
3DBarGraph Object (Page 1894) 


Layer00..10FillColor property 


Description 


Defines or returns the bar fill color for the respective limit"0" to "10" of the "3DBarGraph" object. 
LONG write-read access. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0). 


Layer00..10FillStyle property 


Description 


Defines or returns the bar fill pattern for the respective limit "0" to "10" of the "3DBarGraph" 
object. 


The bar fill color has to differ from the bar color to make the fill pattern visible. 
There is a choice of 50 fill patterns. The "0" fill pattern fills the object with the set background 
color. The "1" fill pattern means neither a background nor a fill pattern is displayed. 
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Layer00..10Value property 


Description 
Defines or returns the value for "Limit 0" to "Limit 10" in the case of the "3DBarGraph" object. 


Monitoring only takes effect when the "Layer00..10Checked" property value is set to "TRUE". 


Example 


The "HMI3DBarGraphConfiguration()" procedure accesses the properties of the 3DBarGraph 
object. In this example the value for limit "0" is defined as "0": 


Sub HMI3DBarGraphConfiguration () 

"VBA556 

Dim obj3DBar As HMI3DBarGraph 

Set obj3DBar = ActiveDocument.HMIObjects.AddHMIObject ("3DBar1", "HMI3DBarGraph") 
With obj3DBar 

.LayerO00Checked = Tru 

.Layer00Value = 0 

End With 

End Sub 


See also 
Layer00..10Checked property (Page 2293) 


3DBarGraph Object (Page 1894) 
LayerDecluttering Property 


Description 


TRUE if showing and hiding objects dependent upon the minimum and maximum zoom set 
for a layer has been enabled. BOOLEAN write-read access. 
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Example: 


In the following example the settings for the lowest layer are configured in the active picture: 


Sub ConfigureSettingsOfLayer () 

"VBA587 

Dim objLayer As HMILayer 

Set objLayer = ActiveDocument.Layers (1) 
With objLayer 

"configure "Layer 0" 

-MinZoom = 10 

-MaxZoom = 100 

-Name = "Configured with VBA" 

End With 

‘define fade-in and fade-out of objects: 
With ActiveDocument 

.LayerDecluttering = Tru 
-ObjectSizeDecluttering = Tru 
-SetDeclutterObjectSize 50, 100 


End With 
End Sub 
See also 
Document Object (Page 1949) 
Editing Layers with VBA (Page 1657) 
Layers Property 
Description 


Returns a listing containing the properties of the layers in the current picture. 


Note 


If the "Layers" property is used, the sequence of HMI objects in the HMlObjects listing can 
change. 
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Example: 


The "LayerlInfo()" procedure outputs the name and zoom configuration for each layer of the 


current picture: 


Sub LayerInfo() 

"VBA588 

Dim colLayers As HMILayers 

Dim objLayer As HMILayer 

Dim iAnswer As Integer 

Set colLayers = ActiveDocument.Layers 

For Each objLayer In colLayers 

With objLayer 

iAnswer = MsgBox("Layername: " & .Name & vbCrLf & "max. 


ZOOM: 


""& .MaxZoom & vbCrLf & "min. 
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ZOOM: " & .MinZoom, vbOKCancel) 
End With 
If vbCancel = iAnswer Then Exit For 
ext objLayer 
End Sub 
See also 
Name Property (Page 2343) 
MinZoom Property (Page 2340) 
MaxZoom Property (Page 2323) 
Layers Object (Listing) (Page 2003) 
Layer Object (Page 2001) 
LDAssignments property 
Description 
Returns a listing with the (foreign language) assignments of display texts that are displayed 
depending on the current "Output Value" in the "TextList" object. 
The assignments depend on the set list type. Specify the list type with the "ListType" property. 
LDFonts Property 
Description 
Returns a listing containing the language identifiers for the configured fonts. 
2298 
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Example: 


Use the LDFonts property to return the LanguageFonts listing. In the following example the 
language identifiers of the configured fonts will be output: 


Sub ShowLanguageFont () 

"VBA589 

Dim colLanguageFonts As HMILanguageFonts 

Dim objLanguageFont As HMILanguageFont 

Dim objButton As HMIButton 

Dim iMax As Integer 

Dim iAnswer As Integer 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMTButton") 
Set colLanguageFonts = objButton.LDFonts 
iMax = colLanguageFonts.Count 

For Each objLanguageFont In colLanguageFonts 


iAnswer = MsgBox("Projected fonts: " & iMax & vbCrLf & "Language-ID: " & 

obj LanguageFont.LanguageID, vbOKCancel1) 

If vbCancel = iAnswer Then Exit For 

ext objLanguageFont 

End Sub 

See also 
StaticText Object (Page 2067) 
OptionGroup Object (Page 2025) 
LanguageFonts Object (Listing) (Page 1997) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 

LDFontsType property 

Description 
Only used internally. 

See also 


FaceplateProperty object (Page 1971) 


LDLabelTexts Property 


Description 


Returns a listing containing the multilingual labels of the user-defined menu or menu entry. 
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3.6 VBA Reference 


Example 


The "CreateMenultem()" procedure creates the "Delete Objects" menu and adds two menu 
entries ("Delete Rectangles" and "Delete Circles"): In this example, multilingual menu labels 


will be created 


Sub CreateMenultem () 


"VBA590 


Dim objMenu As HMIMenu 
Dim objMenuItem As HMIMenuItem 
Dim objLangText As HMILanguageText 


"Add new menu "Delete objects" to menubar: 


Set objMenu = ActiveDocument.CustomMenus.InsertMenu(1, "DeleteObjects", "Delete objects") 


‘Add two menuitems to the new menu 


Set objMenuItem = objMenu.Menultems. InsertMenult 


rectangles") 


Set objMenultem = objMenu.MenuItems.InsertMenultem 


obj 
obj 
obj 


iw) 
chet ch ck @ 


Lang1 
Lang! 
Lang! 


obj 
Sub 


irs 
S 
Q 


n 


m(1l, "DeleteAllRectangles", "Delet 


(2, "DeleteAllCircles", "Delete circles") 


fine foreign-language labels for menu "Delet 
ext = objMenu.LDLabelTexts.Add 


= 


ext = objMenu.LDLabelTexts.Add 


n 


ext = objMenu.LDLabelTexts.Add 


e 


Lang! 


ext = objMenu.LDLabelTexts.Add 


(10337. 


objects": 
English Delete objects") 


(1032, "Greek Delete objects") 
(1034, "Spanish Delete objects") 
(1036, "French Delete objects") 


The "LDLabellnfo()" procedure outputs the labels configured for the "Delete Objects" menu: 


Sub LDLabelInfo() 


"VBA591 
Dim coll 
Dim obj] 


"Save al 


Lang! 


Texts As HMILanguageTexts 


Lang 


Text As HMILanguageText 
Dim iAnswer As Integer 


ll labels of menu in 


to collection "colLangTexts": 


Set colLangTexts = ActiveDocument.CustomMenus ("DeleteObjects") .LDLabelTexts 
For Each objLangText In col 
= MsgBox (obj LangTex 
If vbCancel 


iAnswer 


End Sub 


See also 


2300 


= iAnswer Then 


ext objLangText 


LangTexts 


t.DisplayName, 


Exit For 


Menultem Object (Page 2013) 
Menu Object (Page 2009) 


vbOKCancel) 
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LDNames Property 


Description 


Returns a listing containing the multilingual names of a folder in the Components Library or of 
a layer. 


Example: 


Sub 


Use the LDNames property to return the LanguageTexts listing. In the following example all 
multilingual layer names will be output: 


Explanation: What the example shows 


LDLabelInfo() 


"VBA592 


Dim 
Dim 
Dim 
Dim 
Dim 


colLayerLngTexts As HMILanguageTexts 
objLayerLngText As HMILanguageText 
iIndex As Integer 

iAnswer As Integer 

strResult As String 


iIndex = 1 


For 
' 


iIndex = 1 To ActiveDocument.Layers.Count 


"Save all labels of layers into collection of "colLayerLngTexts": 


Set colLayerLngTexts = ActiveDocument.Layers (iIndex) .LDNames 
For Each objLayerLngText In colLayerLngTexts 
strResult = strResult & vbCrLf & objLayerLngText.LanguageID & "- " & 


objLayerLngText.DisplayName 
Next objLayerLngText 
iAnswer = MsgBox(strResult, vbOKCancel) 


strResult = "™" 
If vbCancel = iAnswer Then Exit For 
ext iIndex 

End Sub 

See also 
Layer Object (Page 2001) 
LanguageTexts Object (Listing) (Page 2000) 
Folderltem Object (Page 1972) 

LDStatusTexts Property 

Description 


Returns a listing containing the multilingual status line texts of a user-defined icon or menu 
entry. 
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Example: 


The "CreateMenultem()" procedure creates the "Delete Objects" menu and adds two menu 
entries ("Delete Rectangles" and "Delete Circles"). In this example, multilingual status line texts 
will be created: 


Sub CreateMenultem () 

"VBA593 

Dim objMenu As HMIMenu 

Dim objMenuIteml As HMIMenuItem 

Dim objMenuItem2 As HMIMenuItem 

Dim objLangStateText As HMILanguageText 


"Add new menu "Delete objects" to menubar: 


Set objMenu = ActiveDocument.CustomMenus.InsertMenu(1, "DeleteObjects", "Delete objects") 
' 


‘Add two menuitems to the new menu 
Set objMenuIteml = objMenu.Menultems.InsertMenuItem(1, "DeleteAllRectangles", "Delet 
rectangles") 
Set objMenuItem2 = objMenu.MenulItems.InsertMenuItem(2, "DeleteAllCircles", "Delete 


circles") 
' 


"Define foreign-language labels for menuitem "Delet ctangles": 
Set objLangStateText = objMenulteml.LDStatusTexts.Add(1033, "English _D te rectangles") 


ia 
( 1 

Set objLangStateText = objMenulteml.LDStatusTexts.Add(1032, "Greek Delete rectangles") 
( 1 
( 


Set objLangStateText = objMenulteml.LDStatusTexts.Add(1034, "Spanish _D te rectangles") 
Set objLangStateText = objMenulteml.LDStatusTexts.Add(1036, "French Delete rectangles") 
End Sub 


The "LDStatusTextInfo()" procedure outputs the status line texts configured for the "Delete 
Objects" menu: 


Sub LDStatusTextInfo () 
"VBA594 
Dim colMenuItems As HMIMenuItems 

Dim objMenuItem As HMIMenuItem 

Dim colStatusLngTexts As HMILanguageTexts 

Dim objStatusLngText As HMILanguageText 

Dim strResult As String 

Dim iAnswer As Integer 

Set colMenuItems = ActiveDocument.CustomMenus ("DeleteObjects") .Menultems 
For Each objMenuItem In colMenuItems 

strResult = "Statustexts of menuitem """ & objMenuItem.Label & """" 

Set colStatusLngTexts = objMenulItem.LDStatusTexts 

For Each objStatusLngText In colStatusLngTexts 

strResult = strResult & vbCrLf & objStatusLngText.DisplayName 

Next objStatusLngText 

iAnswer = MsgBox(strResult, vbOKCancel) 


If vbCancel = iAnswer Then Exit For 
Next objMenuItem 
End Sub 
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See also 
Toolbarltem Object (Page 2083) 
Menultem Object (Page 2013) 
Menu Object (Page 2009) 
LDTexts Property 
Description 
Returns a listing containing the multilingual labels of an object. 
Example: 


The "LDTextInfo()" procedure outputs the labels configured for the Button object. For this 
example to work, create the object "myButton" in the Graphics Designer and configure a 
number of multilingual labels: 


Sub LDTextInfo () 


"VBA595 
Dim col 


iD 


iD 


Dim obj 


ng 
ng 


Texts As HMILanguageTexts 
Text As HMILanguageText 


Dim objButton As HMIButton 
Dim iAnswer As Integer 
Set objButton = ActiveDocument.HMIObjects ("myButton") 


Set colLDLng! 
For Each obj] 


iAnswer 


[Texts = objButton.LDTexts 


LDLngText In colLDLngTexts 


MsgBox (obj LDLngText.DisplayName, vbOKCancel) 


If vbCancel = iAnswer Then Exit For 


End Sub 


See also 


ext obj LDLngText 


Button Object (Page 1921) 
StaticText Object (Page 2067) 
OptionGroup Object (Page 2025) 
CheckBox Object (Page 1924) 


LDTooltipTexts Property 


Description 


Returns a listing containing the multilingual Tooltip texts for a user-defined icon or for an object. 
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Example 


Sub 


The "CreateToolbar()" procedure creates a user-defined toolbar with two icons. Two 
multilingual Tooltip texts are assigned to the first icon: 


CreateToolbar () 


"VBA596 


Dim 


objToolbar As HMIToolbar 
objToolbarItem As HMIToolbarItem 
objLangText As HMILanguageText 
strFileWithPath 


"Create toolbar with two toolbar-items: 


set 
set 


"myFirstToolbaritem") 


set 


"mySecondToolbaritem") 


‘In 


objToolbar = ActiveDocument.CustomToolbars.Add("Tooll 1") 
objToolbarItem = objToolbar.ToolbarItems.InsertToolbarItem(1, "til 1", 


objToolbariItem = objToolbar.ToolbarItems.InsertToolbarItem(2, "til 2", 


order that the example runs correct copy a *.ICO-Graphic 


‘into the "GraCS"-Folder of the actual project. 
"Replace the filename "EZSTART.ICO" in the next commandline 


‘with the name of the ICO-Graphic you copied 
strFileWithPath = Application.ApplicationDataPath & "EZSTART.ICO" 


'To 


assign the symbol-icon to the first toolbaritem 


objToolbar.ToolbarItems(1).Icon = strFileWithPath 


"Define foreign-language tooltiptexts 


set 
Set 


objLangText = objToolbar.ToolbarItems (1) .LDTooltipTexts.Add(1036, "French Tooltiptext") 
objLangText = objToolbar.ToolbarItems (1) .LDTooltipTexts.Add(1034, 


"Spanish Tooltiptext") 


End 


Sub 


Sub 


The "LDTooltipInfo()" procedure outputs all the Tooltip texts configured for the first icon in the 
first user-defined toolbar: 


LDTooltipInfo() 


"VBA597 


Dim 
Dim 
Dim 
set 
For 


n 


colLangTexts As HMILanguageTexts 

objLangText As HMILanguageText 

iAnswer As Integer 

colLangTexts = ActiveDocument.CustomToolbars (1).ToolbarItems(1).LDTooltipTexts 
Each objLangText In colLangTexts 


Ai 


iAnswer = MsgBox (objLangText.DisplayName, vbOKCancel) 
If vbCancel = iAnswer Then Exit For 


End 


2304 


ext objLang! 


a 


ext 
Sub 
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See also 
Toolbarltem Object (Page 2083) 
HM|Object Object (Page 1988) 

Left Property 

Description 
Defines or returns the X coordinate of the object (measured from the top left-hand edge of the 
picture) in pixels. The X-coordinate relates to the top left corner of the rectangle enclosing the 
object. 
View Object 
Defines or returns the X coordinate of the window (measured from the top left-hand edge of 
the Graphics Designer working area) in pixels. 

Example: 


The "RectangleConfiguration()" procedure accesses the properties of the rectangle. In this 
example the rectangle will be moved 40 pixels to the right: 


Sub RectangleConfiguration () 

'VBA598 

Dim objRectangle As HMIRectangle 

Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 
With objRectangle 

-Left = 40 

End With 

End Sub 


See also 
View Object (Page 2102) 
HM|Object Object (Page 1988) 


LeftComma Property 


Description 


Defines or returns the number of digits to the left of the decimal point (0 to 20) for the BarGraph 
object. 
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Example: 


The "BarGraphConfiguration()" procedure configures In this example the number of digits to 
the left of the decimal point will be set to "4". 


Sub BarGraphConfiguration() 

"VBA599 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

-LeftComma = 4 


End With 
End Sub 
See also 
BarGraph Object (Page 1914) 
LightEffect Property 
Description 
TRUE if the light effect of the 3DBarGraph object is activated. BOOLEAN write-read access. 
Example: 


The "HMI3DBarGraphConfiguration()" procedure accesses the properties of the 3DBarGraph 
object. In this example the light effect will be activated: 


Sub HMI3DBarGraphConfiguration () 

"VBA600 

Dim obj3DBar As HMI3DBarGraph 

Set obj3DBar = ActiveDocument.HMIObjects.AddHMIObject ("3DBar1", "HMI3DBarGraph") 
With obj3DBar 

-LightEffect = True 

End With 

End Sub 


See also 
3DBarGraph Object (Page 1894) 
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LimitHigh4 Property 


Description 
Defines or returns the high limit value for "Reserve 4" in the case of the BarGraph object. 


The CheckLimitHigh4 property must be set to TRUE in order that the "Reserve 4" limit value 
can be monitored. 


The type of the evaluation (in percent or absolute) is defined in the TypeLimitHigh4 property. 


Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the high limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "70". 


Sub BarGraphLimitConfiguration () 
"VBA601 

Dim objBarGraph As HMIBarGraph 
Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 
.TypeLimitHigh4 = False 

"Activate monitoring 
-CheckLimitHigh4 = True 

"Set barcolor to "red" 
-ColorLimitHigh4 = RGB(255, 0, 0) 
"Set upper limit to "70" 
-LimitHigh4 = 70 


End With 
End Sub 
See also 
TypeLimitHigh4 Property (Page 2453) 
CheckLimitHigh4 Property (Page 2172) 
BarGraph Object (Page 1914) 
LimitHigh5 Property 
Description 


Defines or returns the high limit value for "Reserve 5" in the case of the BarGraph object. 


The CheckLimitHigh5 property must be set to TRUE in order that the "Reserve 5" limit value 
can be monitored. 


The type of the evaluation (in percent or absolute) is defined in the TypeLimitHigh5 property. 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the high limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "80". 


Sub BarGraphLimitConfiguration () 
"VBA602 

Dim objBarGraph As HMIBarGraph 
Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "“HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 
.TypeLimitHigh5 = False 
"Activate monitoring 
-CheckLimitHigh5 = True 

"Set barcolor to "black" 
-ColorLimitHigh5 = RGB(0O, 0, 0) 
"Set upper limit to "80" 
-LimitHigh4 = 80 


End With 
End Sub 
See also 
TypeLimitHigh5 Property (Page 2453) 
CheckLimitHigh5 Property (Page 2173) 
BarGraph Object (Page 1914) 
LimitLow4 Property 
Description 
Defines or returns the low limit value for "Reserve 4" in the case of the BarGraph object. 
The CheckLimitLow4 property must be set to TRUE in order that the "Reserve 4" limit value 
can be monitored. 
The type of the evaluation (in percent or absolute) is defined in the TypeLimitLow4 property. 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the low limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "5". 


Sub BarGraphLimitConfiguration () 

"'VBA603 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 

.TypeLimitLow4 = False 

"Activate monitoring 

-CheckLimitLow4 = True 


"Set barcolor to "green" 
-ColorLimitLow4 = RGB(0, 255, 0) 
"Set lower limit to "5" 
-LimitLow4 = 5 

End With 

End Sub 


See also 
CheckLimitLow4 Property (Page 2174) 
TypeLimitLow4 Property (Page 2454) 
BarGraph Object (Page 1914) 


LimitLow5 Property 


Description 
Defines or returns the low limit value for "Reserve 5" in the case of the BarGraph object. 


The CheckLimitLow5 property must be set to TRUE in order that the "Reserve 5" limit value 
can be monitored. 


The type of the evaluation (in percent or absolute) is defined in the TypeLimitLow5 property. 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the low limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "0". 


Sub BarGraphLimitConfiguration () 
"VBA604 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis to absolute 
.TypeLimitLow5 = False 

"Activate monitoring 

-CheckLimitLow5 = True 

"Set barcolor to "white" 
-ColorLimitLow5 = RGB(255, 255, 255) 
"Set lower limit to "0" 

-LimitLow5 = 0 

End With 

End Sub 


See also 
BarGraph Object (Page 1914) 
TypeLimitLow5 Property (Page 2455) 
CheckLimitLow5 Property (Page 2175) 


LimitMax Property 


Description 


Defines or returns the high limit value as an absolute value dependent on the data format in 
the case of the IOField object. 


If the value to be displayed exceeds the upper limit value, it is identified by a series of *** , 
indicating it cannot be displayed. 
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Example: 


The "IOFieldConfiguration()" procedure accesses the properties of the I/O field. In this example 
the high limit for a decimal value will be set to "100": 


Sub IO0FieldConfiguration () 

"VBA605 

Dim objJIOField As HMIIOField 

Set obj1IOField = ActiveDocument.HMIObjects.AddHMIObject ("IOField1l", "HMIIOField") 
With objIOField 

.-DataFormat = 1 

-LimitMax = 100 

End With 

End Sub 


See also 
DataFormat Property (Page 2210) 
IOField Object (Page 1992) 


LimitMin Property 


Description 
Defines or returns the low limit value as an absolute value dependent on the data format in 
the case of the IOField object. 
If the value to be displayed exceeds the upper limit value, it is identified by a series of *** , 
indicating it cannot be displayed. 

Example: 


The "lOFieldConfiguration()" procedure accesses the properties of the I/O field. In this example 
the high limit for a decimal value will be set to "0": 


Sub IOFieldConfiguration () 

"VBA606 

Dim objJIOField As HMIIOField 

Set objlIOField = ActiveDocument.HMIObjects.AddHMIObject ("IOField1i", "HMIIOField") 
With obj1IOField 

.-DataFormat = 1 

-LimitMin = 0 

End With 

End Sub 
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See also 
DataFormat Property (Page 2210) 
lOField Object (Page 1992) 
LineJoinStyle property 
Description 
Defines the way that corners are displayed in a tube polygon. 
Angle The tubes are joined at corner points without rounding. 
Round The tubes are rounded at the outside corner points. 
Example 


ListType Property 


Description 
Defines or returns the list type in the case of the TextList object. Value range from 0 to 2. 
List type Assigned Value 
Decimal 0 
Binary 1 
Bit 2 
Example: 


The "TextListConfiguration()" procedure accesses the properties of the object TextList. In this 
example the list type will be set to "Decimal": 


Sub TextListConfiguration () 

"VBA607 

Dim objTextList As HMITextList 

Set objTextList = ActiveDocument.HMIObjects.AddHMIObject ("myTextList", "HMITextList") 
With objTextList 

.ListType = 0 

End With 

End Sub 
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Defines or returns the background color of the button for a locked measuring point in the case 


The LockStatus property must be set to TRUE for the background color to be displayed. 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 


See also 
TextList Object (Page 2076) 
LockBackColor Property 
Description 
of the GroupDisplay object. LONG write-read access. 
Determination of Color Value 
value for each of the three RGB values (value range from 0 to 255). 
Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the background color for a locked measuring point will be set to "Red": 


Sub GroupDisplayConfiguration() 
"VBA608 
Dim objGroupDisplay As HMIGroupDisplay 


Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 


"HMI GroupDisplay") 

With objGroupDisplay 
-LockStatus = True 
»-LockBackColor = RGB(255, 0, O) 
End With 

End Sub 


See also 
LockStatus Property (Page 2315) 
GroupDisplay Object (Page 1980) 
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LockedByCreatorID Property 


Description 


TRUE, if a picture was created and/or referenced by SIMATIC Manager. BOOLEAN read 
access. 


If a picture was created in SIMATIC Manager, you may process and subsequently save it in 
WinCC. You may, however, not delete this picture in WinCC. SIMATIC Manager administers 
a code for each picture, the so-called CreatorID, which cannot be changed in WinCC. 


You may process the picture in WinCC, however, overwriting the picture with a WinCC picture 
(LockedByCreatorID = FALSE) will be prevented. This may be checked by examining the 
LockedByCreatorID property of an existing file prior to writing during the SaveAs method. If 
such a picture is saved into a new (not yet existing) or an existing WinCC picture using the 
SaveAs method, the CreatorID will not be passed on. 


Example 1 


Inn the following example, a picture created with SIMATIC Manager (LockedByCreatorID = 
TRUE) is opened, processed, and saved. The value of the LockedByCreatorID property is not 
changed. 


Sub SaveDocAs_ 1() 

"VBA810 

‘open an existing file, change it and save it 

Dim docOld As Document 

Const strFile As String = "Simatic_001.Pdl" 

' 

Set docOld = Application.Documents.Open(Application.ApplicationDataPath & strFile, 
hmiOpenDocumentTypelInvisible) 

docOld.Width = docOld.Width + 1 

docOld.Save 


MsgBox "LockedByCreatorID = " & docOld.LOckedByCreatorID, vbOKOnly, "Result" 
' 


docOld.Close 
Set docOld = Nothing 


' 


End Sub 
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Example 2 


In this example, a new picture is saved as a new file using the SaveAs method. To check if 
the picture is permitted to be saved, the LockedByCreatorID property is checked. In the new 
file the LockedByCreator property is reset. 


Sub SaveDocAs 2() 

'VBA811 

‘create a new file and overwrite it to an existing file, 
‘if it is not ‘locked by CreatorID' 

Dim docNew As Document 

Dim docOld As Document 

Const strFile As String = "Simatic _001.Pdl1" 


Set docNew = Application.Documents.Add(hmiOpenDocumentTypeInvisible) 

Set docOld = Application.Documents.Open(Application.ApplicationDataPath & strFile, 
hmiOpenDocumentTypelInvisible) 

' 

If docOld.LockedByCreatorID = False Then 

docOld.Close 

docNew.SaveAs (Application.ApplicationDataPath & strFile) 


Else 

sgBox "File cannot be stored (LockedByCreatorID). ", vbOKOnly, "Result" 
End If 

' 

docOld.Close 

docNew.Close 

Set docOld = Nothing 

Set docNew = Nothing 


End Sub 
See also 
SaveAs Method (Page 1880) 
Document Object (Page 1949) 
LockStatus Property 
Description 


TRUE if alocked measuring point is to be displayed with the Object GroupDisplay. BOOLEAN 
write-read access. 
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Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the background color for a locked measuring point will be set to "Red": 


Sub GroupDisplayConfiguration() 

"VBA609 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMIGroupDisplay") 

With objGroupDisplay 


-LockStatus = True 
»-LockBackColor = RGB(255, 0, O) 
End With 

End Sub 

See also 


GroupDisplay Object (Page 1980) 


LockText Property 


Description 
Defines the button labels for a locked measuring point in the case of the GroupDisplay object. 


The LockStatus property must be set to TRUE for the label to be displayed. 


Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the label for a locked measuring point will be set to "Locked": 


Sub GroupDisplayConfiguration () 

"VBA610 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMIGroupDisplay") 

With objGroupDisplay 


-LockStatus = True 
-LockText = "gesperrt" 
End With 

End Sub 
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See also 
LockStatus Property (Page 2315) 
GroupDisplay Object (Page 1980) 

LockTextColor Property 

Description 
Defines or returns the color of the button label for a locked measuring point in the case of the 
GroupDisplay object. LONG write-read access. 
The LockStatus property must be set to TRUE for the background color to be displayed. 
Determination of Color Value 
The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 

Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the button label for a locked measuring point will be set to "Yellow": 


Sub GroupDisplayConfiguration() 

"VBA611 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMI GroupDisplay") 

With objGroupDisplay 


-LockStatus = True 

-LockTextColor = RGB(0, 255, 255) 
End With 

End Sub 

See also 


LockStatus Property (Page 2315) 
GroupDisplay Object (Page 1980) 
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LongStrokesBold Property 


Description 


TRUE if the long strokes on the scale of the BarGraph object are to be displayed in bold. 
BOOLEAN write-read access. 


Example: 


The "BarGraphConfiguration()" procedure configures In this example the long strokes will not 
be displayed in bold: 


Sub BarGraphConfiguration() 
"VBA612 
Dim objBarGraph As HMIBarGraph 


Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "“HMIBarGraph") 
With objBarGraph 


-LongStrokesBold = Fals 


End With 
End Sub 
See also 
BarGraph Object (Page 1914) 
LongStrokesOnly Property 
Description 
TRUE if just the long strokes on the scale of the BarGraph object are to be displayed. 
BOOLEAN write-read access. 
Example: 


The "BarGraphConfiguration()" procedure configures In this example, only the long strokes 
will be displayed: 


Sub BarGraphConfiguration () 

'VBA613 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

-LongStrokesOnly = True 

End With 

End Sub 
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See also 
BarGraph Object (Page 1914) 
LongStrokesSize Property 
Description 
The "BarGraphConfiguration()" procedure configures 
Example: 


In this example the length of the axis section strokes will be set to "10". 


Sub BarGraphConfiguration() 

"VBA614 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

.-LongStrokesSize = 10 

End With 

End Sub 


See also 
AxisSection Property (Page 2130) 
BarGraph Object (Page 1914) 


LongStrokesTextEach Property 


Description 


Defines or returns which strokes will be labeled when displaying the scale on the BarGraph 
object (1 = every stroke, 2 = every second stroke, etc.). 
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Example: 


The "BarGraphConfiguration()" procedure configures In this example every third stroke will be 
labeled: 


Sub BarGraphConfiguration () 
"VBA615 
Dim objBarGraph As HMIBarGraph 


Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 


LongStrokesTextEach = 3 
End With 
End Sub 
See also 
BarGraph Object (Page 1914) 
M 
Macro Property 
Description 
For a user-defined menu entry or icon, defines the VBA macro that will be executed upon 
selection. 
Example: 


In the following example, a user-defined menu with two menu entries is created, which retrieve 
two different VBA macros: 


Sub CreateDocumentMenusUsingMacroProperty () 

"VBA616 

Dim objDocMenu As HMIMenu 

Dim objMenuItem As HMIMenuItem 

Set objDocMenu = ActiveDocument.CustomMenus.InsertMenu(1, "DocMenul", "Doc Menu_1") 
objMenultem = objDocMenu.MenulItems.InsertMenultem(1, "dmIteml_ 1", "My first menuitem") 
objMenultem = objDocMenu.MenuItems.InsertMenulItem(2, "dmIteml 2", "My second menuitem") 


t 
t 


Ss 
S 
' 


'To assign a macro to every menuitem: 
With ActiveDocument.CustomMenus ("DocMenul1") 


-MenulItems ("dmIteml_1").Macro = "TestMacrol" 
-MenulItems ("dmIteml 2") .Macro = "TestMacro2" 
End With 

End Sub 
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You can call the following two procedures via the menu items in the user-defined menu 
"DocMenu1": 


Sub TestMacrol () 
sgBox "TestMacrol is executed" 
End Sub 


Sub TestMacro2 () 
sgBox "TestMacro2 is executed" 


End Sub 

See also 
Toolbarltem Object (Page 2083) 
Menultem Object (Page 2013) 
How to assign VBA macros to menus and toolbars (Page 1642) 

Marker Property 

Description 
TRUE if the limit values are to be displayed as a scale value in the case of the BarGraph object. 
BOOLEAN write-read access. 

Example: 


The "BarGraphConfiguration()" procedure configures In this example, the limit values will be 
displayed as scale values: 


Sub BarGraphConfiguration() 

'VBA617 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "“HMIBarGraph") 
With objBarGraph 

-Marker = True 

End With 

End Sub 


See also 
BarGraph Object (Page 1914) 
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Max Property 

Description 
Defines or returns the absolute value in the case of a full value display. 
This value is displayed if the scale display is active. 

Example: 


The "BarGraphConfiguration()" procedure configures In this example the absolute value will 
be set to "10". 


Sub BarGraphConfiguration () 
'VBA618 
Dim objBarGraph As HMIBarGraph 


Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "“HMIBarGraph") 
With objBarGraph 


-Max = 10 
End With 
End Sub 
See also 
Slider object (Page 2062) 
BarGraph Object (Page 1914) 
3DBarGraph Object (Page 1894) 
MaxIndex property 
Description 


Shows the highest index of all configurable alarm and status combinations at the 
"HMlAdvancedStateDisplay" object. 


MaximizeButton Property 


Description 


TRUE if the ApplicationWindow object can be maximized in Runtime. BOOLEAN write-read 
access. 
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The "ApplicationWindowConfig" procedure accesses the properties of the application window. 
In this example the application window will receive a Maximize button in Runtime: 


Sub ApplicationWindowConfig() 
"VBA619 
Dim objAppWindow As HMIApplicationWindow 


Set objAppWindow = ActiveDocument.HMIObjects.AddHMIObject ("AppWindow1", 


"HMIApplicationWindow") 
With objAppWindow 
-MaximizeButton = 
End With 

End Sub 


True 


See also 
ApplicationWindow Object (Page 1911) 


MaxZoom Property 


Description 


Defines or returns the maximum zoom level for the layer. 


Example: 


The "Layerlnfo()" procedure outputs the name and zoom configuration for each layer of the 


current picture: 


Sub LayerInfo() 

"VBA620 

Dim colLayers As HMILayers 
objSingleLayer As HMILayer 
iAnswer As Integer 

Set colLayers = ActiveDocument.Layers 
For Each objSingleLayer In colLayers 
With objSingleLayer 


Dim 
Dim 


iAnswer = MsgBox("Layername: " & .Name & vbCrLf & "Min. zoom: 
ZOOM: " & .MaxZoom, vbOKCancel) 

End With 

If vbCancel = iAnswer Then Exit For 

ext objSingleLayer 

End Sub 
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See also 
Layer Object (Page 2001) 
Editing Layers with VBA (Page 1657) 


MCGUBackColorOff-Eigenschaft 


Description 


In the case of the GroupDisplay object, defines or returns the background color for the "Went 
Out Unacknowledged" status when the flash status is "Off". LONG write-read access. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the background color when the flash status is "Off" will be set to "Red": 


Sub GroupDisplayConfiguration() 

"VBA621 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMTGroupDisplay") 

With objGroupDisplay 

-MCGUBackColorOff = RGB(255, 0, 0) 

End With 

End Sub 


See also 
GroupDisplay Object (Page 1980) 


MCGUBackColorOn Property 


Description 


In the case of the GroupDisplay object, defines or returns the background color for the "Went 
Out Unacknowledged" status when the flash status is "On". LONG write-read access. 
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Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the background color when the flash status is "On" will be set to "White": 


Sub GroupDisplayConfiguration() 

"VBA622 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMTGroupDisplay") 

With objGroupDisplay 

»-MCGUBackColorOn = RGB(255, 255, 255) 

End With 

End Sub 


See also 
GroupDisplay Object (Page 1980) 


MCGUBackFlash Property 


Description 


TRUE if the background to the GroupDisplay object is to flash when a message goes out 
unacknowledged. BOOLEAN write-read access. 


Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the background color is to flash when a message goes out unacknowledged: 


Sub GroupDisplayConfiguration() 

"VBA623 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMI GroupDisplay") 

With objGroupDisplay 

.-MCGUBackFlash = True 

End With 

End Sub 
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See also 
GroupDisplay Object (Page 1980) 

MCGUTextColorOff Property 

Description 
In the case of the GroupDisplay object, defines or returns the text color for the "Went Out 
Unacknowledged" status when the flash status is "Off". LONG write-read access. 
Determination of Color Value 
The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 

Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the background color to the text when the flash status is "Off" will be set to 
"Blue": 


Sub GroupDisplayConfiguration() 

"VBA624 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMI GroupDisplay") 

With objGroupDisplay 

»-MCGUTextColorOff = RGB(O, O, 255) 

End With 

End Sub 


See also 
GroupDisplay Object (Page 1980) 


MCGUTextColorOn Property 


Description 


In the case of the GroupDisplay object, defines or returns the background color to the text for 
the "Went Out Unacknowledgea" status when the flash status is "On". LONG write-read access. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
2326 System Manual, 02/2016, ASE37536061-AA 


VBA for Automated Configuration 
3.6 VBA Reference 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 


In this example the background color to the text when the flash status is "On" will be set to 
"Black": 


Sub GroupDisplayConfiguration () 

"VBA625 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMTGroupDisplay") 

With objGroupDisplay 

»-MCGUTextColorOn = RGB(O, O, O) 

End With 

End Sub 


See also 
GroupDisplay Object (Page 1980) 


MCGUTextFlash Property 


Description 


TRUE if the font for the GroupDisplay object is to flash when a message goes out 
unacknowledged. BOOLEAN write-read access. 
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Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the font is to flash when a message goes out unacknowledged: 


Sub GroupDisplayConfiguration() 

"VBA626 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMI GroupDisplay") 

With objGroupDisplay 

-MCGUTextFlash = True 


End With 
End Sub 
See also 
GroupDisplay Object (Page 1980) 
MCKOBackColorOff Property 
Description 
In the case of the GroupDisplay object, defines or returns the background color for the "Came 
In" status when the flash status is "Off". LONG write-read access. 
Determination of Color Value 
The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the background color when the flash status is "Off" will be set to "Red": 


Sub GroupDisplayConfiguration() 

"VBA627 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMTGroupDisplay") 

With objGroupDisplay 

»-MCKOBackColorOff = RGB(255, 0, O) 

End With 

End Sub 


WinCC: Scripting (VBS, ANSI-C, VBA) 
2328 System Manual, 02/2016, ASE37536061-AA 


VBA for Automated Configuration 
3.6 VBA Reference 


See also 
GroupDisplay Object (Page 1980) 


MCKOBackColorOn Property 


Description 


In the case of the GroupDisplay object, defines or returns the background color for the "Came 
In" status when the flash status is "On". LONG write-read access. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the background color when the flash status is "On" will be set to "White": 


Sub GroupDisplayConfiguration() 

"VBA628 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMI GroupDisplay") 

With objGroupDisplay 

»-MCKOBackColorOn = RGB(255, 255, 255) 

End With 

End Sub 


See also 
GroupDisplay Object (Page 1980) 


MCKOBackFlash Property 


Description 


TRUE if the background to the GroupDisplay object is to flash when a message goes out 
unacknowledged. BOOLEAN write-read access. 
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Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the background color is to flash when a message goes out unacknowledged: 


Sub GroupDisplayConfiguration() 

"VBA629 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMTGroupDisplay") 

With objGroupDisplay 

-MCKOBackFlash = True 


End With 
End Sub 
See also 
GroupDisplay Object (Page 1980) 
MCKOTextColorOff Property 
Description 
In the case of the GroupDisplay object, defines or returns the text color for the "Came In" status 
when the flash status is "Off". LONG write-read access. 
Determination of Color Value 
The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the background color to the text when the flash status is "Off" will be set to 
"Blue": 


Sub GroupDisplayConfiguration() 

"VBA630 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMI GroupDisplay") 

With objGroupDisplay 

»-MCKOTextColorOff = RGB(O, O, 255) 

End With 

End Sub 


WinCC: Scripting (VBS, ANSI-C, VBA) 
2330 System Manual, 02/2016, A5E37536061-AA 


VBA for Automated Configuration 
3.6 VBA Reference 


See also 
GroupDisplay Object (Page 1980) 


MCKOTextColorOn Property 


Description 


In the case of the GroupDisplay object, defines or returns the background color to the text for 
the "Came In" status when the flash status is "On". LONG write-read access. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the background color to the text when the flash status is "On" will be set to 
"Black": 


Sub GroupDisplayConfiguration () 

"VBA631 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMI GroupDisplay") 

With objGroupDisplay 

-MCKOTextColorOn = RGB(0O, 0, 0) 

End With 

End Sub 


See also 
GroupDisplay Object (Page 1980) 


MCKOTextFlash Property 


Description 


TRUE if the font for the GroupDisplay object is to flash when a message goes out 
unacknowledged. BOOLEAN write-read access. 
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Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the font is to flash when a message goes out unacknowledged: 


Sub GroupDisplayConfiguration() 

"'VBA632 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMTGroupDisplay") 

With objGroupDisplay 

-MCKOTextFlash = True 


End With 
End Sub 
See also 
GroupDisplay Object (Page 1980) 
MCKQBackColorOff Property 
Description 
In the case of the GroupDisplay object, defines or returns the background color for the "Went 
Out Acknowledged" status when the flash status is "Off". LONG write-read access. 
Determination of Color Value 
The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the background color when the flash status is "Off" will be set to "Red": 


Sub GroupDisplayConfiguration() 

"VBA633 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMI GroupDisplay") 

With objGroupDisplay 

-MCKQBackColorOff = RGB(255, 0, 0) 

End With 

End Sub 
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See also 
GroupDisplay Object (Page 1980) 


MCKQBackColorOn Property 


Description 


In the case of the GroupDisplay object, defines or returns the background color for the "Went 
Out Acknowledged” status when the flash status is "On". LONG write-read access. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the background color when the flash status is "On" will be set to "White": 


Sub GroupDisplayConfiguration() 

"VBA634 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMI GroupDisplay") 

With objGroupDisplay 

»-MCKQBackColorOn = RGB(255, 255, 255) 


End With 
End Sub 
See also 
GroupDisplay Object (Page 1980) 
MCKQBackFlash Property 
Description 


TRUE if the background to the GroupDisplay object is to flash when a message goes out 
acknowledged. BOOLEAN write-read access. 
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Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the background color is to flash when a message goes out unacknowledged: 


Sub GroupDisplayConfiguration() 

"VBA635 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMTGroupDisplay") 

With objGroupDisplay 

-MCKQBackFlash = True 


End With 
End Sub 
See also 
GroupDisplay Object (Page 1980) 
MCKQTextColorOff Property 
Description 
In the case of the GroupDisplay object, defines or returns the text color for the "Went Out 
Acknowledged" status when the flash status is "Off". LONG write-read access. 
Determination of Color Value 
The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the background color to the text when the flash status is "Off" will be set to 
"Blue": 


Sub GroupDisplayConfiguration() 

"VBA636 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMI GroupDisplay") 

With objGroupDisplay 

»-MCKOTextColorOff = RGB(O, O, 255) 

End With 

End Sub 
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See also 
GroupDisplay Object (Page 1980) 


MCKQTextColorOn Property 


Description 
In the case of the GroupDisplay object, defines or returns the background color to the text for 
the "Went Out Acknowledged" status when the flash status is "On". LONG write-read access. 
Determination of Color Value 
The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 

Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the background color to the text when the flash status is "On" will be set to 
"Black": 


Sub GroupDisplayConfiguration() 

"VBA637 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMTGroupDisplay") 

With objGroupDisplay 

-MCKOTextColorOn = RGB(O, O, O) 

End With 

End Sub 


See also 
GroupDisplay Object (Page 1980) 


MCKQTextFlash Property 


Description 


TRUE if the font for the GroupDisplay object is to flash when a message goes out 
acknowledged. BOOLEAN write-read access. 
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Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the font is to flash when a message goes out unacknowledged: 


Sub GroupDisplayConfiguration() 

'VBA638 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMTGroupDisplay") 

With objGroupDisplay 

-MCKQOTextFlash = True 


End With 
End Sub 
See also 
GroupDisplay Object (Page 1980) 
MCText Property 
Description 
Defines or returns the label for the appropriate message class in the case of the GroupDisplay 
object. 
Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the label for the "Alarm High" message class will be set to "Alarm High": 


Sub GroupDisplayConfiguration() 

"VBA639 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMI GroupDisplay") 

With objGroupDisplay 


-MessageClass = 0 
-MCText = "Alarm High" 
End With 

End Sub 
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See also 
MessageClass Property (Page 2339) 
GroupDisplay Object (Page 1980) 
Menultems Property 
Description 
Returns a listing containing all the menu entries in the user-defined menu. 
Example: 


The "CreateMenultem()" procedure creates the "Delete Objects" menu and adds two menu 
entries ("Delete Rectangles" and "Delete Circles"). In this example the labels will then be output: 


Sub CreateMenultem () 

'VBA640 

Dim objMenu As HMIMenu 

Dim objMenuItem As HMIMenuItem 

Dim iIndex As Integer 

iIndex = 1 

' 

‘Add new menu "Delete objects" to the menubar: 

Set objMenu = ActiveDocument.CustomMenus.InsertMenu(1, "DeleteObjects", "Delete objects") 


‘Add two menuitems to menu "Delete objects" 

Set objMenuItem = objMenu.Menultems.InsertMenuItem(1, "DeleteAllRectangles", "Delet 
rectangles") 

Set objMenulItem = objMenu.MenuItems.InsertMenuItem(2, "DeleteAllCircles", "Delete circles") 


"Output label of menu: 

MsgBox ActiveDocument.CustomMenus (1) .Label 
' 

"Output labels of all menuitems: 

For iIndex = 1 To objMenu.MenulItems.Count 
sgBox objMenu.Menultems (iIndex) .Label 

ext iIndex 

End Sub 


See also 
Menu Object (Page 2009) 
Menultem Object (Page 2013) 
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MenultemType Property 


Description 


Returns the type for a user-defined menu entry. Read only access. 


Returned Value Type of Menu Entry 

0 Separator (Separator) 

1 Submenu (SubMenu) 

2 Menu Entry (Menultem) 


Example: 


The "ShowMenuTypes()" procedure outputs the types for the menu entries in the first user- 
defined menu: 


Sub ShowMenuTypes () 

"VBA641 

Dim iMaxMenuItems As Integer 

Dim iMenultemType As Integer 

Dim strMenuItemType As String 

Dim iIndex As Integer 

iMaxMenuItems = ActiveDocument.CustomMenus (1) .MenuItems.Count 


For iIndex = 1 To iMaxMenuItems 
iMenuItemType = ActiveDocument.CustomMenus (1) .MenuItems (iIndex) .MenuItemTyp 
Select Case iMenultemTyp 
Case 0 
strMenulItemType = "Trennstrich (Separator)" 
Case 1 
strMenultemType = "Untermentt (SubMenu)" 
Case 2 
strMenulItemType = "Mentieintrag (Menultem)" 
End Select 
sgBox iIndex & ". Menuitemtype: " & strMenultemType 
Next iIndex 
End Sub 
See also 


Menultem Object (Page 2013) 
Menu Object (Page 2009) 
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MenuToolBarConfig Property 


Description 


Specifies the configuration file with the user-defined menu and toolbars for the 


"HM|IPictureWindow" object or returns the name of the configuration file. STRING write-read 
access. 


MessageClass Property 


Description 


Specifies the respective message type (Alarm High, Alarm Low, Warning High, Warning Low, 
etc.) for which the attribute settings "Display Text", "Came In", "Came In Acknowledged" and 
"Went Out Unacknowledged" are configured for the "GroupDisplay" and 
"AdvancedAnalogDisplay" objects. 


MessageClass Assigned Value 
AlarmHigh 
AlarmLow 


WarningHigh 


WarningLow 


Tolerance High 


Tolerance Low 
AS Control System Fault 
AS Process Control Error 


OS Process Control Error 


COINIOD)/ aA! R)w]hmMs]—->|]o 


Example 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the background color for the "AlarmHigh" message type when the flash status 
is "Off" will be set to "Red": 


Sub GroupDisplayConfiguration() 

"VBA642 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMTGroupDisplay") 

With objGroupDisplay 


-MessageClass = 0 
-MCGUBackColorOff = RGB(255, 0, 0) 
End With 

End Sub 
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See also 
GroupDisplay Object (Page 1980) 

Min Property 

Description 
Defines or returns the absolute value in the case of the smallest value display. 
This value is displayed if the scale display is active. 

Example: 


The "BarGraphConfiguration()" procedure configures In this example the absolute value will 
be set to "1". 


Sub BarGraphConfiguration() 
"VBA643 
Dim objBarGraph As HMIBarGraph 


Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 


-Min = 1 
End With 
End Sub 
See also 
Slider object (Page 2062) 
BarGraph Object (Page 1914) 
3DBarGraph Object (Page 1894) 
MinZoom Property 
Description 


Defines or returns the minimum zoom level for the layer. 
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The "Layerlnfo()" procedure outputs the name and zoom configuration for each layer of the 


current picture: 


Sub LayerInfo() 

"VBA644 

Dim colLayers As HMILayers 

Dim objLayer As HMILayer 

Dim strMaxZoom As String 

Dim strMinZoom As String 

Dim strLayerName As String 

Dim iAnswer As Integer 

Set colLayers = ActiveDocument.Layers 
For Each objLayer In colLayers 
With objLayer 


strMinZoom = .MinZoom 
strMaxZoom = .MaxZoom 
strLayerName = .Nam 
iAnswer = MsgBox("Layername: " & strLayerName & vbCrLf & "Min. zoom: 
vbCrLf & "Max. zoom: " & strMaxZoom, vbOKCancel) 
End With 
If vbCancel = iAnswer Then Exit For 
ext objLayer 
End Sub 
See also 


Layer Object (Page 2001) 
Editing Layers with VBA (Page 1657) 


Modified Property 


Description 


" 


& strMinZoom & 


TRUE if the source code for a script or picture has been changed. BOOLEAN read access. 
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Example: 


In the following example a check will be made on whether the active picture has been changed: 


Sub CheckModificationOfActiveDocument () 
"VBA645 

Dim strCheck As String 

Dim bModified As Boolean 

bModified = ActiveDocument .Modified 
Select Case bModified 

Case True 

strCheck = "Active document is modified" 
Case False 

strCheck = "Active document is not modified" 
End Select 

sgBox strCheck 

End Sub 


See also 
Scriptinfo Object (Page 2058) 
Document Object (Page 1949) 


Moveable Property 


Description 


TRUE if the ApplicationWindow and PictureWindow objects can be moved in Runtime. 
BOOLEAN write-read access. 


Example: 


The "ApplicationWindowConfig" procedure accesses the properties of the application window. 
In this example it shall be possible to move the application window in Runtime: 


Sub ApplicationWindowConfig() 

"VBA646 

Dim objAppWindow As HMIApplicationWindow 

Set objAppWindow = ActiveDocument.HMIObjects.AddHMIObject ("AppWindow1", 
"HMIApplicationWindow") 

With objAppWindow 

-Moveable = True 

End With 

End Sub 
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See also 
PictureWindow Object (Page 2029) 
ApplicationWindow Object (Page 1911) 
N-O 
Name Property 
Description 
Returns the name of the object. STRING read access. 
Example: 


The "Layerlnfo()" procedure outputs the name and zoom configuration for each layer of the 
current picture: 


Sub LayerInfo() 

"VBA647 

Dim colLayers As HMILayers 

Dim objLayer As HMILayer 

Dim strMaxZoom As String 

Dim strMinZoom As String 

Dim strLayerName As String 

Dim iAnswer As Integer 

Set colLayers = ActiveDocument.Layers 
For Each objLayer In colLayers 
With objLayer 


strMinZoom = .MinZoom 
strMaxZoom = .MaxZoom 
strLayerName = .Nam 
iAnswer = MsgBox("Layername: " & strLayerName & vbCrLf & "Min. zoom: " & strMinZoom & 
vbCrLf & "Max. zoom: " & strMaxZoom, vbOKCancel) 
End With 
If vbCancel = iAnswer Then Exit For 
ext objLayer 
End Sub 
See also 


Trigger Object (Page 2087) 
SymbolLibrary Object (Page 2074) 
Property Object (Page 2042) 
HMIObject Object (Page 1988) 
Layer Object (Page 2001) 
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Folderltem Object (Page 1972) 
Document Object (Page 1949) 
Application Object (Page 1909) 


Name Property (Folderltem) 


Description 
Returns the internal name of the specified object of the "Folderltem" type. Read only access. 


Example: 


In this example the internal name is output for the "PC" object contained in the Global 
Components Library: 


Sub ShowInternalNameOfFolderItem () 

"VBA536 

Dim objGlobalLib As HMISymbolLibrary 

Set objGlobalLib = Application.SymbolLibraries (1) 

sgBox objGlobalLib.FolderItems(2).Folder (2) .Folder.Item(1).Name 
End Sub 


See also 
Folderltem Object (Page 1972) 
Accessing the component library with VBA (Page 1646) 


NegativeValue Property 


Description 
Use the BinaryResultInfo property to return the BinaryResultInfo object. 
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Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog, a tag name will be assigned and the associated property values will be assigned to 
both the binary value ranges: 


Sub AddDynamicDialogToCircleRadiusTypeBinary () 
"VBA648 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle C", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeBool 


.-BinaryResultInfo.NegativeValue = 20 
.-BinaryResultInfo.PositiveValue = 40 
End With 

End Sub 

See also 


VBA Reference (Page 1745) 
PositiveValue Property (Page 2380) 
BinaryResultInfo Object (Page 1918) 


NibbleSelect property 


Description 


Only used internally. 


See also 
AdvancedStateDisplay object (Page 1905) 


Number Property 


Description 


Returns the layer number of a "Layer" type object. The counting starts with 1. The first layer, 
"LayerO", returns the value "0". READ access. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 2345 


VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


This example outputs the name, number and index of a layer: 


Sub ShowLayerWithNumbers () 

"VBA803 

Dim colLayers As HMILayers 

Dim objLayer As HMILayer 

Dim iAnswer As Integer 

Dim iIndex As Integer 

iIndex = 1 

Set colLayers = ActiveDocument.Layers 


For Each objLayer In colLayers 
iAnswer = MsgBox("Layername: " & objLayer.Name & vbCrLf & "Layernumber: " & objLayer.Number 
& vbCrLf & "Layersindex: " & iIndex, vbOKCancel) 
iIndex = iIndex + 1 
If vbCancel = iAnswer Then Exit For 
ext objLayer 
End Sub 
See also 


Layer Object (Page 2001) 


NumberLines Property 


Description 


TextList 


Defines for the "TextList object" how many lines the selection list should contain or returns the 
value. If the configured lines with their number, font size and font do not fit into the dimensions 
of the object, a vertical scroll bar is added to the selection list. 


Combo box and list box 


Defines or returns the number of lines of text for the "Combo box" and "List box" objects. You 
can define a maximum of 32,000 lines. 


At the same time, the value of the "Number of rows" attribute specifies the high limit value for 
the "Index" attribute in the "Font" property group. Changing the value can have the following 
effects: 


e Increasing the number: New lines are added at the bottom. The default labeling of the new 
filed can be changed using the "Text" attribute in the "Font" property group. 


@ Reducing the number: All lines are removed for which the value of the "Index" attribute is 
higher than the new number. 
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The "TextListConfiguration()" procedure accesses the properties of the "TextList" object. In 
this example a selection list is created and the number of visible lines is set to three: 


Sub TextListConfiguration () 


"VBA649 


Dim objTextList As HMITextList 


‘Insert new 


TextList in current picture: 

Set objTextList = ActiveDocument.HMIObjects.AddHMIObject ("myTextList", 
With objText 
-NumberLines=3 


List 


End With 
End Sub 
See also 
TextList Object (Page 2076) 
ObjectName Property 
Description 


"HMI TextList") 


Depending on the source and destination object types for the direct connection, either defines 
or returns the name of the constant, object or tag. 


The two tables show you when you must use the ObjectName property. A "--" means that the 
property is assigned an empty string (") by default when the DirectConnection object is created. 


Source object type (SourceLink Property) 


Type Property 
hmiSourceTypeConstant 


AutomationName Property 


ObjectName Property 


Name of the constant (e.g. the 
picture name) 


hmiSourceTypeProperty 


Property of the source object 
(e.g. "Top") 


Name of the source object (e.g. 
"Rectangle_A") 


hmiSourceTypePropertyOfThi- 
sObject 


hmiSourceTypeVariableDirect -- Tag name 
hmiSourceTypeVariablelndirect -- Tag name 
Destination object type (DestinationLink Property) 

Type Property AutomationName Property ObjectName Property 


hmiDestTypeProperty 


Property of the destination ob- 
ject (e.g. "Left") 


Name of the destination object 
(e.g. "Rectangle_A") 


hmiDestTypePropertyOfThisObject 
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Type Property AutomationName Property ObjectName Property 
hmiDestTypePropertyOfActual- Property of the destination ob- | -- 

Window ject (e.g. "Left") 

hmiDestTypeVariableDirect -- Tag name 
hmiDestTypeVariablelndirect -- Tag name 
hmiDestTypeDirectMessage -- Tag name 
hmiDestTypelndirectMessage -- Tag name 
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Example: 


Sub Direct 
"VBA650 

Dim objBut 
Dim objRec 
Dim objRec 


3.6 VBA Reference 


In the following example the X position of "Rectangle_A" is copied to the Y position of 


"Rectangle_B" in Runtime by clicking on the button: 


Connection () 


ton As HMIButton 

tangleA As HMIRectangle 

tangleB As HMIRectangle 

nt As HMITEvent 

Connection As HMIDirectConnection 


op = 100 


With objRe 
-Top = 250 
-Left = 40 
-BackColor 
End With 
With ob jBu 
-Top = 10 
-Left = 10 
-Width = 1 
-Text = "S 
End With 

' 


"Directcon 
Set objDir 
objButton. 
With objDi 


ctangleA 


ctangleB 


0) 
= RGB(255, 0, 0) 


tton 


00 
etPosition" 


nection is initiated by mouseclick: 
Connection = 


rConnection 


"Sourceobject: Property "Top" of Rectangle A 


-SourceLin 
-SourceLin 


-SourceLin 
' 


k.Type = hmiSourceTypeProperty 
k.ObjectName = "Rectangle A" 
k.AutomationName = "Top" 


'Targetobject: Property "Left" of Rectangle B 
.DestinationLink.Type = hmiDestTypeProperty 
.DestinationLink.ObjectName = "Rectangle B" 
.DestinationLink.AutomationName = "Left" 

End With 

End Sub 
See also 


Type Property (Page 2450) 
SourceLink Property (Page 2422) 
DestinationLink Property (Page 2211) 
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tangleA = ActiveDocument .HMIObjects.AddHMIObject ("Rectangle A", "HMIRectangle") 


tangleB = ActiveDocument .HMIObjects.AddHMIObject ("Rectangle B", "HMIRectangle") 
ton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMIButton") 


Events (1) .Actions.AddAction (hmiActionCreationTypeDirectConnection) 
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AutomationName Property (Page 2124) 
SourceLink Object (Page 2065) 


DestLink Object (Page 1945) 


ObjectSizeDecluttering Property 


Description 
TRUE, if objects of the specified picture outside of two configured sizes are to be faded out. 
BOOLEAN write-read access. 
Define the size range with the aid of the SetDeclutterObjectSize method. 

Example: 


In the following example the settings for the lowest layer are configured in the active picture: 


Sub ConfigureSettingsOfLayer () 

"'VBA651 

Dim objLayer As HMILayer 

Set objLayer = ActiveDocument.Layers (1) 
With objLayer 

"Configure "Layer 0" 

-MinZoom = 10 

-MaxZoom = 100 

-Name = "Configured with VBA" 

End With 

"Define fade-in and fade-out of objects: 
With ActiveDocument 

.LayerDecluttering = Tru 
-ObjectSizeDecluttering = Tru 
.SetDeclutterObjectSize 50, 100 


End With 
End Sub 
See also 
Document Object (Page 1949) 
Editing Layers with VBA (Page 1657) 
OffsetLeft Property 
Description 


Defines or returns the distance of the picture from the left edge of the picture window. 
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Example: 


The "PictureWindowConfig" procedure accesses the properties of the picture window. In this 
example the picture window will be configured 


Sub PictureWindowConfig() 

"VBA652 

Dim objPicWindow As HMIPictureWindow 

Set objPicWindow = ActiveDocument.HMIObjects.AddHMIObject ("PicWindowl", "HMIPictureWindow") 
With objPicWindow 

-AdaptPicture = False 

-AdaptSize = False 

-Caption = True 


-CaptionText = "Picturewindow in runtime" 
-OffsetLeft = 5 

-OffsetTop = 10 

"Replace the picturename "Test.PDL" with the name of 
‘an existing document from your "GraCS"-Folder of your active project 
-PictureName = "Test.PDL" 

-ScrollBars = True 

.ServerPrefix = ™" 

-TagPrefix = "Struct." 

-UpdateCycle = 5 

-Zoom = 100 

End With 

End Sub 


See also 
PictureWindow Object (Page 2029) 


OffsetTop Property 


Description 


Defines or returns the distance of the picture from the top edge of the picture window. 
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Example: 


The "PictureWindowConfig" procedure accesses the properties of the picture window. In this 
example the picture window will be configured 


Sub PictureWindowConfig() 

"VBA653 

Dim objPicWindow As HMIPictureWindow 

Set objPicWindow = ActiveDocument.HMIObjects.AddHMIObject ("PicWindow1l", "HMIPictureWindow") 
With objPicWindow 

-AdaptPicture = False 

-AdaptSize = False 

-Caption = True 


-CaptionText = "Picturewindow in runtime" 
-OffsetLeft = 5 

-OffsetTop = 10 

"Replace the picturename "Test.PDL" with the name of 
‘an existing document from your "GraCS"-Folder of your active project 
.PictureName = "Test.PDL" 

-ScrollBars = True 

.ServerPrefix = ™" 

-TagPrefix = "Struct." 

-UpdateCycle = 5 

-Zoom = 100 

End With 

End Sub 


See also 
PictureWindow Object (Page 2029) 


OnTop Property 


Description 


TRUE if the ApplicationWindow object is always in the foreground in Runtime. BOOLEAN write- 
read access. 
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Example: 


The "ApplicationWindowConfig" procedure accesses the properties of the application window. 
In this example the application window will always be in the foreground in Runtime: 


Sub ApplicationWindowConfig() 

"VBA654 

Dim objAppWindow As HMIApplicationWindow 

Set objAppWindow = ActiveDocument.HMIObjects.AddHMIObject ("AppWindow1", 
"HMIApplicationWindow") 

With objAppWindow 

-OnTop = True 

End With 

End Sub 


See also 


ApplicationWindow Object (Page 1911) 
Operation Property 


Description 


TRUE if the object can be used or operated in Runtime. BOOLEAN write-read access. 
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Example: 


In this example the status of the operator-control enables will be output for all objects in the 
active picture: 


Sub ShowOperationStatusOfAllObjects () 
"VBA655 

Dim objObject As HMTObject 

Dim bStatus As Boolean 

Dim strStatus As String 

Dim strName As String 

Dim iMax As Integer 

Dim iIndex As Integer 

Dim iAnswer As Integer 

iMax = ActiveDocument.HMIObjects.Count 


iIndex = 1 
For iIndex = 1 To iMax 
strName = ActiveDocument.HMIObjects (iIndex) .ObjectNam 


bStatus = ActiveDocument.HMIObjects (iIndex) .Operation 
Select Case bStatus 
Case True 


strStatus = "yes" 
Case False 
strStatus = "no" 
End Select 
iAnswer = MsgBox("Object: " & strName & vbCrLf & "Operator-Control enable: " & strStatus, 
vbOKCancel) 
If vbCancel = iAnswer Then Exit For 


ext iIndex 
If 0 = iMax Then MsgBox "No objects in the active document." 
End Sub 


See also 
HMIObject Object (Page 1988) 
Document Object (Page 1949) 


OperationMessage Property 


Description 


TRUE, if a message should be output upon successful operation. The reason for the operation 
can only be input if the "OperationReport" property is set to "True". BOOLEAN write-read 
access. 


The operation is sent to the message system, and is archived. Using the message system, a 
message may be output in a message line, for example. 
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Example: 


The "|OFieldConfiguration()" procedure accesses the properties of the I/O field. In this 
example, an operation is supposed to be sent to the message system: 


Sub IOFieldConfiguration () 

"VBA656 

Dim objJIOField As HMIIOField 

Set obj1IOField = ActiveDocument.HMIObjects.AddHMIObject ("IOField1i", "HMIIOField") 
With objIOField 


-OperationReport = True 
-OperationMessage = True 
End With 

End Sub 

See also 


OperationReport Property (Page 2355) 
TextList Object (Page 2076) 

Slider object (Page 2062) 
OptionGroup Object (Page 2025) 
IOField Object (Page 1992) 

CheckBox Object (Page 1924) 


OperationReport Property 


Description 
TRUE, if the reason for an operation should be recorded. BOOLEAN write-read access. 


When the object is used or operated in Runtime, a dialog opens in which the operator can 
input the reason for the operation in the form of text. The operation is sent to the message 
system, and is archived. 
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Example: 


The "|OFieldConfiguration()" procedure accesses the properties of the I/O field. In this 
example, an operation is supposed to be sent to the message system: 


Sub IOFieldConfiguration () 

"VBA657 

Dim objJIOField As HMIIOField 

Set obj1I0OField = ActiveDocument.HMIObjects.AddHMIObject ("IOField1i", "HMIIOField") 
With objIOField 


-OperationReport = True 
-OperationMessage = True 
End With 

End Sub 

See also 


OperationMessage Property (Page 2354) 
TextList Object (Page 2076) 

Slider object (Page 2062) 

OptionGroup Object (Page 2025) 

IOField Object (Page 1992) 

CheckBox Object (Page 1924) 


Orientation Property 


Description 


TRUE, when the text in the object should be displayed horizontally. BOOLEAN write-read 
access. 


Note 


It is only the text that is displayed either horizontally or vertically. The position of the object 
remains unchanged. 
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Example: 


The "ButtonConfiguration()" procedure accesses the properties of the button. In this example 
the text will be displayed vertically: 


Sub ButtonConfiguration() 

"VBA658 

Dim objButton As HMIButton 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Buttonl", “HMIButton") 
With objButton 

-Width = 150 

-Height = 150 


.Text = "Text is displayed vertical" 
-Orientation = False 

End With 

End Sub 
See also 


TextList Object (Page 2076) 
StaticText Object (Page 2067) 
OptionGroup Object (Page 2025) 
IOField Object (Page 1992) 
CheckBox Object (Page 1924) 
Button Object (Page 1921) 


OriginalPropertyName property 


Description 
Only used internally. 
See also 
FaceplateObjects object (Page 1971) 
OutputFormat Property 
Description 


Defines how the output value shall be displayed, or returns the set value. The representation 
is dependent on the data format. 
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Example: 


The "|OFieldConfiguration()" procedure accesses the properties of the I/O field. In this 
example, data type "Decimal" will be set for the I/O field: The output value will be displayed 
with two decimals and three digits to the right of the decimal point: 


Sub IOFieldConfiguration () 

"VBA659 

Dim objJIOField As HMIIOField 

Set obj1IOField = ActiveDocument.HMIObjects.AddHMIObject ("IOField1i", "HMIIOField") 
With objIOField 

.DataFormat = 1 

-OutputFormat = "99,999" 

End With 

End Sub 


See also 
DataFormat Property (Page 2210) 
lOField Object (Page 1992) 


OutputValue Property 


Description 
Defines or returns presetting for the value to be displayed. 
This value is used in Runtime when the associated tag cannot be connected or updated when 
a picture is started. 

Example 


The "|OFieldConfiguration()" procedure accesses the properties of the I/O field. In this 
example, the output value is set to "0": 


Sub IOFieldConfiguration () 

"VBA660 

Dim objJIOField As HMIIOField 

Set obj1IOField = ActiveDocument.HMIObjects.AddHMIObject ("IOField1i", "HMIIOField") 
With obj1IOField 

-OutputValue = "0" 

End With 

End Sub 
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See also 
TextList Object (Page 2076) 
IOField Object (Page 1992) 
OutputValue property 
Description 
Specifies the interconnection with any analog / text tag. The analog display represents the 
value of this tag in the configured colors depending on the alarm state. 
P-Q 


PaintColor_QualityCodeBad property 


Description 
Defines the color in which the grid is shown when a poor status exists, for example, if the 
connection to the server is interrupted. 
Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


PaintColor_QualityCodeUnCertain property 


Description 
Defines the color with which the grid is shown in an uncertain status. 
Determination of Color Value 
The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 

Parent Property 

Description 


Returns the higher-ranking object in the specified object. Read only access. 
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Example: 


See also 


2360 


In the following example a copy of the active picture is created and the name of the picture is 
then output with the aid of the Parent property: 


Sub ExampleForParent () 
"VBA661 
Dim objView As HMIView 


Set objView = ActiveDocument.Views.Add 


MsgBox objView.Parent.Name 


End Sub 


Toolbars Object (Listing) (Page 2081) 

Menu Object (Page 2009) 

Document Object (Page 1949) 

Views Object (Listing) (Page 2103) 

View Object (Page 2102) 

VariableTriggers Object (Listing) (Page 2101) 
VariableTrigger Object (Page 2099) 
VariableStateValues Object (Listing) (Page 2097) 
VariableStateValue Object (Page 2096) 
Trigger Object (Page 2087) 

Toolbarltems Object (Listing) (Page 2085) 
Toolbarltem Object (Page 2083) 

Toolbar Object (Page 2080) 

TextList Object (Page 2076) 

SymbolLibraries Object (Listing) (Page 2073) 
SymbolLibrary Object (Page 2074) 
StatusDisplay Object (Page 2070) 

StaticText Object (Page 2067) 

SourceLink Object (Page 2065) 

Slider object (Page 2062) 

SelectedObjects object (Listing) (Page 2060) 
ScriptInfo Object (Page 2058) 
RoundRectangle Object (Page 2055) 
RoundButton Object (Page 2052) 
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Rectangle Object (Page 2049) 

Properties Object (Listing) (Page 2041) 
Property Object (Page 2042) 

PolyLine Object (Page 2038) 

Polygon Object (Page 2035) 

PictureWindow Object (Page 2029) 
PieSegment Object (Page 2032) 
OptionGroup Object (Page 2025) 
OLEObject Object (Page 2023) 

Menultems Object (Listing) (Page 2015) 
Menultem Object (Page 2013) 

Menus Object (Listing) (Page 2011) 

Line Object (Page 2004) 

Layers Object (Listing) (Page 2003) 

Layer Object (Page 2001) 

LanguageTexts Object (Listing) (Page 2000) 
LanguageText Object (Page 1999) 
LanguageFonts Object (Listing) (Page 1997) 
LanguageFont Object (Page 1996) 

IOField Object (Page 1992) 

HMlObjects Object (Listing) (Page 1990) 
HMIObject Object (Page 1988) 
HMIDefaultObjects Object (Listing) (Page 1985) 
GroupedObjects Object (Listing) (Page 1983) 
GroupDisplay Object (Page 1980) 

Group Object (Page 1978) 

GraphicObject Object (Page 1975) 
Folderltems Object (Listing) (Page 1973) 
Folderltem Object (Page 1972) 

Events Object (Listing) (Page 1967) 

Event Object (Page 1966) 

EllipseSegment Object (Page 1963) 
EllipseArc Object (Page 1960) 

Ellipse Object (Page 1957) 

DynamicDialog Object (Page 1955) 
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Documents Object (Listing) (Page 1952) 
DirectConnection Object (Page 1947) 
DestLink Object (Page 1945) 
DataLanguages Object (Listing) (Page 1942) 
DataLanguage Object (Page 1941) 
CustomizedObject Object (Page 1938) 
ConnectionPoints Object (Listing) (Page 1936) 
CircularArc Object (Page 1931) 

Circle Object (Page 1928) 

CheckBox Object (Page 1924) 

Button Object (Page 1921) 

BitResultInfo Object (Page 1919) 
BinaryResultInfo Object (Page 1918) 
BarGraph Object (Page 1914) 
ApplicationWindow Object (Page 1911) 
Actions Object (Listing) (Page 1898) 
3DBarGraph Object (Page 1894) 


ParentCookie property 


Description 


Only used internally. 


See also 
FaceplateProperty object (Page 1971) 


PasswordLevel Property 


Description 


Defines the authorization for operation (e.g. no input or no triggering actions) of the object. 


PasswordLevel Assigned Value 


<No Access Security> 0 


User Administration 


Value input 


Process controlling 


BLO! N|] => 


Picture editing 
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PasswordLevel Assigned Value 
Screen change 5 
Window selection 6 
Hard copy 7 
Confirm alarms 8 
Lock alarms 9 
Free alarms 10 
Message editing 11 
Start archive 12 
Stop archive 13 
Edit archive values 14 
Archive editing 15 
Action editing 16 
Project Manager 17 
Activate remote 1000 
Configure remote 1001 
Just monitor 1002 


You must first define the operator authorizations in the User Administrator. 


Example: 


See also 


HM|lObject Object (Page 1988) 


Path Property 


Description 


Returns the full path of the folder in which the specified picture is stored. Read only access. 


Example: 


In this example the path to the folder of the active picture will be output: 


Sub ShowDocumentPath () 
"VBA663 

sgBox ActiveDocument. Path 
End Sub 
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See also 
Document Object (Page 1949) 

Pathname Property 

Description 
Returns the internal access path to the Components Library for the specified object of the 
"Folderltem" type. Read only access. 

Example: 


In this example the internal access path is output for the "PC" object contained in the Global 
Components Library: 


Sub ShowInternalNameOfFolderItem () 

"VBA664 

Dim objGlobalLib As HMISymbolLibrary 

Set objGlobalLib = Application.SymbolLibraries (1) 

sgBox objGlobalLib.FolderItems (2) .Folder(2) .Folder.Item(1).PathName 
End Sub 


See also 
Folderltem Object (Page 1972) 
Accessing the component library with VBA (Page 1646) 


PdlProtection property 


Description 
Sets a password for a process picture or faceplate type or deletes the password. Write access. 


Note 
Significance of the password protection 
With the PdlProtection property, you can only assign a password to process pictures or 


faceplate types to, for example, protect the VBA scripts contained in the pictures against 
unauthorized access. 
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Examples 


In this example, a password is set for the active picture: 


Sub ProtectPicture () 

'VBA854 

ActiveDocument.PdlProtection = "Test123" 
End Sub 


Password protection for the active picture is removed in this example: 


Sub UnprotectPicture () 

"VBA855 
ActiveDocument.PdlProtection = "™" 
End Sub 


Note 
Write access only 


Read access to the password is prevented due to security reasons. 


PicDeactReferenced-Eigenschaft 


Description 


TRUE if the picture assigned to the "Deactivated" status is to be saved in the RoundButton 
object. Otherwise, only the associated object reference is saved. BOOLEAN write-read access. 


Example: 


The "RoundButtonConfiguration()" procedure accesses the properties of the RoundButton. In 
this example the picture assigned to the "Deactivated" status will be referenced: 


Sub RoundButtonConfiguration () 

"VBA665 

Dim objRoundButton As HMIRoundButton 

Set objRoundButton = ActiveDocument.HMIObjects.AddHMIObject ("RButtonl", "HMTRoundButton") 
With objRoundButton 

.PicDeactReferenced = Fals 

End With 

End Sub 
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See also 
RoundButton Object (Page 2052) 


PicDeactTransparent Property 


Description 
Defines or returns which color of the bitmap object (.bmp, .dib) assigned to the "Disabled" 
status should be set to "transparent". LONG write-read access. 
The color is only set to "Transparent" if the value of the "PicDeactUseTransColor" property is 
"True". 
Determination of Color Value 
The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 

Example: 


The "RoundButtonConfiguration()" procedure accesses the properties of the RoundButton. In 
this example the color "Red" assigned in the Bitmap object is to be displayed transparent when 
in the "Deactivated" status. 


Sub RoundButtonConfiguration () 

"VBA666 

Dim objRoundButton As HMIRoundButton 

Set objRoundButton = ActiveDocument.HMIObjects.AddHMIObject ("RButtonl", "HMITRoundButton") 
With objRoundButton 

.PicDeactTransparent = RGB(255, 0, 0) 

.PicDeactUseTransColor = True 

End With 

End Sub 


See also 
PicDeactUseTransColor Property (Page 2367) 
RoundButton Object (Page 2052) 
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PicDeactUseTransColor Property 


Description 


TRUE, when the transparent color defined by the "PicDeactTransparent" property for the 
"Disable" status should be used. BOOLEAN write-read access. 


Example: 


The "RoundButtonConfiguration()" procedure accesses the properties of the RoundButton. In 
this example the color "Red" assigned in the Bitmap object is to be displayed transparent when 
in the "Deactivated" status: 


Sub RoundButtonConfiguration () 

"VBA667 

Dim objRoundButton As HMIRoundButton 

Set objRoundButton = ActiveDocument.HMIObjects.AddHMIObject ("RButtonl", "HMTRoundButton") 
With objRoundButton 

.PicDeactTransparent = RGB(255, 0, 0) 

.PicDeactUseTransColor = True 

End With 

End Sub 


See also 
PicDeactTransparent Property (Page 2366) 
RoundButton Object (Page 2052) 


PicDownReferenced Property 


Description 


TRUE if the picture assigned to the "On" status is to be saved in the RoundButton object. 
Otherwise, only the associated object reference is saved. BOOLEAN write-read access. 
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Example: 


The "RoundButtonConfiguration()" procedure accesses the properties of the RoundButton. In 
this example the picture assigned to the "On" status will be referenced: 


Sub RoundButtonConfiguration () 

"VBA668 

Dim objRoundButton As HMIRoundButton 

Set objRoundButton = ActiveDocument.HMIObjects.AddHMIObject ("RButtonl", "HMTRoundButton") 
With objRoundButton 

.PicDownReferenced = Fals 

End With 

End Sub 


See also 
RoundButton Object (Page 2052) 


PicDownTransparent Property 


Description 


Defines or returns which color of the bitmap object (.bmp, .dib) assigned to the "On" status 
should be set to "transparent". LONG write-read access. 


The color is only set to "Transparent" if the value of the "PicDownUseTransColor" property is 
"True". 
Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
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Example: 


The "RoundButtonConfiguration()" procedure accesses the properties of the RoundButton. In 
this example the color "Yellow" assigned in the Bitmap object is to be displayed transparent 
when in the "Deactivated" status. 


Sub RoundButtonConfiguration () 

"VBA669 

Dim objRoundButton As HMIRoundButton 

Set objRoundButton = ActiveDocument.HMIObjects.AddHMIObject ("RButtonl", "HMTRoundButton") 
With objRoundButton 

.PicDownTransparent = RGB(255, 255, 0) 

.PicDownUseTransColor = True 

End With 

End Sub 


See also 
PicDownUseTransColor Property (Page 2369) 
RoundButton Object (Page 2052) 


PicDownUseTransColor Property 


Description 


TRUE, when the transparent color defined by the "PicDownTransparent" property for the "On" 
status should be used. BOOLEAN write-read access. 


Example: 


The "RoundButtonConfiguration()" procedure accesses the properties of the RoundButton. In 
this example the color "Yellow" assigned in the Bitmap object is to be displayed transparent 
when in the "Deactivated" status: 


Sub RoundButtonConfiguration () 

"VBA670 

Dim objRoundButton As HMIRoundButton 

Set objRoundButton = ActiveDocument.HMIObjects.AddHMIObject ("RButtonl", "HMTRoundButton") 
With objRoundButton 

.PicDownTransparent = RGB(255, 255, 0) 

.PicDownUseTransColor = True 

End With 

End Sub 
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See also 
PicDownTransparent Property (Page 2368) 
RoundButton Object (Page 2052) 


PicReferenced Property 


Description 


TRUE if the picture assigned to the GraphicObject object is to be referenced and not saved in 
the object. BOOLEAN write-read access. 


Example: 


The "GraphicObjectConfiguration()" procedure accesses the properties of the graphics object. 
In this example the assigned picture will be referenced: 


Sub GraphicObjectConfiguration () 

"VBA671 

Dim objGraphicObject As HMIGraphicObject 

Set objGraphicObject = ActiveDocument.HMIObjects.AddHMIObject ("GraphicObject1", 
"HMIGraphicObject") 

With objGraphicObject 

.PicReferenced = Tru 

End With 

End Sub 


See also 
GraphicObject Object (Page 1975) 


PictAlignment property 


Description 


As the "Picture alignment" attribute, it defines the position and scaling of the picture placed on 
the button or round button. 


centered The picture is positioned, centered in the original proportions. 


Left justified The picture is positioned with original proportions, with left justification on 
the left side of the button. 


Right justified The picture is positioned with original proportions, with right justification on 
the right side of the button. 


Stretched The picture is scaled to a square and is adapted to the size of the button. 
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PicTransColor Property 


Description 


Defines or returns which color of the assigned bitmap object (.bmp, .dib) should be set to 
"transparent". LONG write-read access. 


The color is only set to "Transparent" if the value of the "PicUseTransColor" property is "True". 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


Example: 


The "GraphicObjectConfiguration()" procedure accesses the properties of the graphics object. 
In this example the color "Blue" assigned in the Bitmap object is to be displayed transparent: 


Sub GraphicObjectConfiguration () 

"VBA672 

Dim objGraphicObject As HMIGraphicObject 

Set objGraphicObject = ActiveDocument.HMIObjects.AddHMIObject ("GraphicObject1", 
"HMIGraphicObject") 

With objGraphicObject 

-PicTransColor = 16711680 

.PicUseTransColor = True 

End With 

End Sub 


See also 
GraphicObject Object (Page 1975) 


PictureDeactivated Property 


Description 
Defines the picture to be displayed in the "Disable" status or returns the picture name. 


The picture (*.BMP or *.DIB) must be located in the "GraCS" directory of the current project 
so that it can be integrated. 
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Example: 


The "ButtonConfiguration()" procedure accesses the properties of the round button. In this 
example the pictures for the "On" and "Off" states will be defined: 


Sub ButtonConfiguration () 

"VBA673 

Dim objRoundButton As HMIRoundButton 

Set objRoundButton = ActiveDocument.HMIObjects.AddHMIObject ("RButtonl", "HMTRoundButton") 
With objRoundButton 


'Toi use this example copy a Bitmap-Graphic 

"to the "GraCS"-Folder of the actual project. 

"Replace the picturename "TestPicturel.BMP" with the name of 
"the picture you copied 

.PictureDeactivated = "TestPicturel.BMP" 

End With 

End Sub 


See also 
RoundButton Object (Page 2052) 
PicReferenced Property (Page 2370) 


PictureDown Property 


Description 
Defines the picture to be displayed in the "On" status or returns the picture name. 
The picture (*.BMP or *.DIB) must be located in the "GraCS" directory of the current project 
so that it can be integrated. 
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Example: 


The "ButtonConfiguration()" procedure accesses the properties of the round button. In this 
example the pictures for the "On" and "Off" states will be defined: 


Sub ButtonConfiguration() 
"VBA674 


Dim objButton As HMIButton 


Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Button1l", "“HMIButton") 
With objButton 


'To use this exampl 


copy two Bitmap-Graphics 
‘to the "GraCS"-Folder of the actual project. 


"Replace the picturenames "TestPicturel.BMP" and "TestPicture2.BMP" 
‘with the names of the pictures you copied 


-PictureDown = "TestPicturel.BMP" 
-PictureUp = "TestPicture2.BMP" 
End With 

End Sub 
See also 


RoundButton Object (Page 2052) 
PictureName Property 


Description 


Defines the picture to be displayed in the picture window in Runtime or returns the picture 
name. 


The picture (*.BMP or *.DIB) must be located in the "GraCS" directory of the current project 
so that it can be integrated. 
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Example: 


The "PictureWindowConfig" procedure accesses the properties of the picture window. In this 
example the picture window will be configured: 


Sub PictureWindowConfig() 

"VBA675 

Dim objPicWindow As HMIPictureWindow 

Set objPicWindow = ActiveDocument.HMIObjects.AddHMIObject ("PicWindowl", "HMIPictureWindow") 
With objPicWindow 

-AdaptPicture = False 

-AdaptSize = False 

-Caption = True 


-CaptionText = "Picturewindow in runtime" 
-OffsetLeft = 5 

-OffsetTop = 10 

"Replace the picturename "Test.PDL" with the name of 
‘an existing document from your "GraCS"-Folder of your active project 
.PictureName = "Test.PDL" 

-ScrollBars = True 

.ServerPrefix = ™" 

-TagPrefix = "Struct." 

-UpdateCycle = 5 

-Zoom = 100 

End With 

End Sub 


See also 
PictureWindow Object (Page 2029) 


PictureUp Property 


Description 
Defines the picture to be displayed in the "Off" status or returns the picture name. 


The picture (*.BMP or *.DIB) must be located in the "GraCS" directory of the current project 
so that it can be integrated. 
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Example: 


The "ButtonConfiguration()" procedure accesses the properties of the button. In this example 
the pictures for the "On" and "Off" states will be defined: 


Sub ButtonConfiguration() 

"VBA676 

Dim objButton As HMIButton 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Button1l", "“HMIButton") 
With objButton 


'To use this example copy two Bitmap-Graphics 

‘to the "GraCS"-Folder of the actual project. 

"Replace the picturenames "TestPicturel.BMP" and "TestPicture2.BMP" 
‘with the names of the pictures you copied 


-PictureDown = "TestPicturel.BMP" 
-PictureUp = "TestPicture2.BMP" 
End With 

End Sub 
See also 


RoundButton Object (Page 2052) 
Button Object (Page 1921) 


PicUpReferenced Property 


Description 


TRUE if the picture assigned to the "Off" status is to be saved in the RoundButton object. 
Otherwise, only the associated object reference is saved. BOOLEAN write-read access. 


Example: 


The "RoundButtonConfiguration()" procedure accesses the properties of the RoundButton. In 
this example the picture assigned to the "Off" status will be referenced: 


Sub RoundButtonConfiguration () 

"VBA677 

Dim objRoundButton As HMIRoundButton 

Set objRoundButton = ActiveDocument.HMIObjects.AddHMIObject ("RButtonl", "HMTRoundButton") 
With objRoundButton 

.PicUpReferenced = Fals 

End With 

End Sub 
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See also 
RoundButton Object (Page 2052) 


PicUpTransparent Property 


Description 
Defines or returns which color of the bitmap object (.bmp, .dib) assigned to the "Off" status 
should be set to "transparent". LONG write-read access. 
The color is only set to "Transparent" if the value of the "PicUpUseTransColor" property is 
"True". 
Determination of Color Value 
The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 

Example: 


The "RoundButtonConfiguration()" procedure accesses the properties of the RoundButton. In 
this example the color "Blue" assigned in the Bitmap object is to be displayed transparent in 
the status "Off". 


Sub RoundButtonConfiguration () 

'VBA678 

Dim objRoundButton As HMIRoundButton 

Set objRoundButton = ActiveDocument.HMIObjects.AddHMIObject ("RButtonl", "HMITRoundButton") 
With objRoundButton 

.PicUpTransparent = RGB(0, 0, 255) 

.PicUpUseTransColor = True 

End With 

End Sub 


See also 
PicUpUseTransColor Property (Page 2377) 
RoundButton Object (Page 2052) 
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PicUpUseTransColor Property 


Description 


TRUE, when the transparent color defined by the "PicUpTransparent" property for "Off" status 
should be used. BOOLEAN write-read access. 


Example: 


The "RoundButtonConfiguration()" procedure accesses the properties of the RoundButton. In 
this example the color "Blue" assigned in the Bitmap object is to be displayed transparent in 
the status "Off": 


Sub RoundButtonConfiguration () 

"VBA679 

Dim objRoundButton As HMIRoundButton 

Set objRoundButton = ActiveDocument.HMIObjects.AddHMIObject ("RButtonl", "HMTRoundButton") 
With objRoundButton 

.PicUpTransparent = RGB(0, 0, 255) 

.PicUpUseTransColor = True 

End With 

End Sub 


See also 
PicUpTransparent Property (Page 2376) 
RoundButton Object (Page 2052) 


PicUseTransColor Property 


Description 


TRUE if the transparent color defined with the "PicTransColor" property is to be used for the 
"Deactivated" status. BOOLEAN write-read access. 
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Example: 


The "GraphicObjectConfiguration()" procedure accesses the properties of the graphics object. 
In this example the color "Blue" assigned in the Bitmap object is to be displayed transparent: 


Sub GraphicObjectConfiguration () 

"VBA680 

Dim objGraphicObject As HMIGraphicObject 

Set objGraphicObject = ActiveDocument.HMIObjects.AddHMIObject ("GraphicObject1", 
"HMIGraphicObject") 

With objGraphicObject 

.-PicTransColor = RGB(0O, 0, 255) 

.PicUseTransColor = True 

End With 

End Sub 


See also 
PicTransColor Property (Page 2371) 
GraphicObject Object (Page 1975) 


Pinnable property 


Description 


Only used internally. 


See also 
PictureWindow Object (Page 2029) 


Pinned property 


Description 


Only used internally. 


See also 
PictureWindow Object (Page 2029) 
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PointCount Property 


Description 


Defines or returns the number of corner points in the case of the Polygon and Polyline objects. 
Each corner point has position coordinates and is identified via an index. 


Example: 


For this example to work, insert a polyline called "Polyline1" into the active picture: The 
"PolyLineCoordsOutput" procedure then outputs the coordinates of all the corner points in the 
polyline: 


Sub PolyLineCoordsOutput () 

"VBA681 

Dim iPcIndex As Integer 

Dim iPosX As Integer 

Dim iPosY As Integer 

Dim iIndex As Integer 

Dim objPolyLine As HMIPolyLine 

Set objPolyLine = Application.ActiveDocument .HMIObjects.AddHMIObject ("PolyLinel", 
"HMIPolyLine") 


"Determine number of corners from "PolyLinel": 
iPcIndex = objPolyLine.PointCount 


‘Output of x/y-coordinates from every corner: 


For iIndex = 1 To iPcIndex 
With objPolyLine 

-index = iIndex 

iPosX = .ActualPointLeft 
iPosY = .ActualPointTop 

sgBox iIndex & ". corner:" & vbCrLf & "x-coordinate: " & iPosX & vbCrLf & "y-coordinate: 
" & iPosYy 

End With 

ext iIndex 
End Sub 

List of links 

See also 


Index Property (Page 2276) 
ActualPointTop Property (Page 2110) 
ActualPointLeft Property (Page 2109) 
PolyLine Object (Page 2038) 

Polygon Object (Page 2035) 
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Position Property 


Description 
The value for position determines the sequence, in which menu entries and icons are assigned 
in user-defined menus and toolbars or how user-defined menus are arranged in the menu bar. 
Write/Read access. 
A value of "1" means position 1 (start). 

Example: 


In the following example the position of all menu entries in the first user-defined menu in the 
active picture will be output: So that this example will work, first carry out the example shown 
under the heading "InsertSubMenu". 


Sub ShowPositionOfCustomMenuItems () 

"VBA683 

Dim objMenu As HMIMenu 

Dim iMaxMenuItems As Integer 

Dim iPosition As Integer 

Dim iIndex As Integer 

Set objMenu = ActiveDocument.CustomMenus (1) 


iMaxMenuItems = objMenu.MenulItems.Count 
For iIndex = 1 To iMaxMenuItems 
iPosition = objMenu.MenulItems (iIndex) .Position 
sgBox "Position of the " & iIndex & ". menuitem: " & iPosition 
Next iIndex 
End Sub 
See also 


Toolbarltem Object (Page 2083) 
Menultem Object (Page 2013) 

Menu Object (Page 2009) 
InsertSubmenu Method (Page 1854) 


PositiveValue Property 


Description 


Defines the value for the dynamic property if the configured tag returns a non-zero value, or 
returns the value. 
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Example: 


Use the BinaryResultInfo property to return the BinaryResultInfo object. In the following 
example the radius of a circle will be dynamically configured using the Dynamic dialog, a tag 
name will be assigned and the associated property values will be assigned to both the binary 
value ranges: 


Sub AddDynamicDialogToCircleRadiusTypeBool () 
"VBA684 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle C", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
"'NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeBool 


.BinaryResultInfo.NegativeValue = 20 
.BinaryResultInfo.PositiveValue = 40 
End With 

End Sub 

See also 


NegativeValue Property (Page 2344) 
BinaryResultInfo Object (Page 1918) 
VBA Reference (Page 1745) 


PredefinedAngels Property 


Description 
Defines or returns the depth of the display of the 3DBarGraph object. Value range from 0 to 3. 


Display Assigned Value 
Cavalier 0 
Isometric 1 
Axonometric 2 
Freely Defined 3 
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Example: 


The "HMI3DBarGraphConfiguration()" procedure accesses the properties of the 3DBarGraph 
object. In this example the depth display will be set to "Isometric": 


Sub HMI3DBarGraphConfiguration () 
"VBA685 

Dim obj3DBar As HMI3DBarGraph 
Set obj3DBar = ActiveDocument.HMIObjects.AddHMIObject ("3DBar1", "HMI3DBarGraph") 
With obj3DBar 

"Depth-angle a = 15 degrees 
-AngleAlpha = 15 
.PredefinedAngles = 1 
"Depth-angle b = 45 degrees 
-AngleBeta = 45 

End With 

End Sub 


See also 
3DBarGraph Object (Page 1894) 


Pressed Property 


Description 


TRUE, when the Button or RoundButton object is pressed. BOOLEAN write-read access. 


Example: 


The "RoundButtonConfiguration()" procedure accesses the properties of the RoundButton. In 
this example the RoundButton object will be set to "Pressed": 


Sub RoundButtonConfiguration () 

"VBA686 

Dim objRoundButton As HMIRoundButton 

Set objRoundButton = ActiveDocument.HMIObjects.AddHMIObject ("RButtonl", "HMTRoundButton") 
With objRoundButton 

.-Pressed = True 

End With 

End Sub 


See also 
RoundButton Object (Page 2052) 
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PrioAlarm..Warning property 


Description 


Specifies the priority at one of the following states or message types: 


Alarm 

Warning 

Tolerance 

AS Process Control Error 
AS Control System Fault 


Operator request 


PrioBit16..31 property 


Description 


The property indicates the priority of the respective bit in the group value for the alarm 
evaluation for the advanced analog and status display. The alarm evaluation starts at the 
highest priority (priority 1). Bits that are not used for the alarm evaluation are assigned priority 
0. 


If the group value contains multiple bits, the priority determines which status is displayed. 


Process Property 


Description 


Defines or returns presetting for the value to be displayed. 


This value is used in Runtime when the associated tag cannot be connected or updated when 
a picture is started. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 2383 


VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


The "HMI3DBarGraphConfiguration()" procedure accesses the properties of the 3DBarGraph 
object. In this example the default value will be set to "100": 


Sub HMI3DBarGraphConfiguration () 
"VBA687 

Dim obj3DBar As HMI3DBarGraph 
Set obj3DBar = ActiveDocument.HMIObjects.AddHMIObject ("3DBar1", "HMI3DBarGraph") 
With obj3DBar 

"Depth-angle a = 15 degrees 
-AngleAlpha = 15 

"Depth-angle b = 45 degrees 
-AngleBeta = 45 

-Process = 100 

End With 

End Sub 


See also 
Slider object (Page 2062) 
OptionGroup Object (Page 2025) 
CheckBox Object (Page 1924) 
BarGraph Object (Page 1914) 
3DBarGraph Object (Page 1894) 


Process property 


Description 


Here the first tag is stored that is used for status value calculation for the 
"HMlAdvancedStateDisplay" object. 


Use the "BitPositionO..3" properties to specify the bit position of these tags that is taken into 
account for the status value calculation. This results in the statuses to which you can then 
assign pictures. 


Process‘ property 


Description 


Here the second tag is stored that is used for status value calculation for the 
"HMlAdvancedStateDisplay" object. 
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Use the "BitPositionO..3" properties to specify the bit position of these tags that is taken into 
account for the status value calculation. This results in the statuses to which you can then 
assign pictures. 


Process2 property 


Description 


Here the third tag is stored that is used for status value calculation for the 
"HMIlAdvancedStateDisplay" object. 


Use the "BitPositionO..3" properties to specify the bit position of these tags that is taken into 
account for the status value calculation. This results in the statuses to which you can then 
assign pictures. 


Process3 property 


Description 


Here the fourth tag is stored that is used for status value calculation for the 
"HMlAdvancedStateDisplay" object. 


Use the "BitPositionO..3" properties to specify the bit position of these tags that is taken into 
account for the status value calculation. This results in the statuses to which you can then 
assign pictures. 


ProfileName Property 


Description 


Returns the name of the specified application. Read only access. 


Example: 
In this example the name of the "Graphics Designer" application will be output: 


Sub ShowProfileName () 

"VBA688 

sgBox Application.ProfileName 
End Sub 


See also 
Application Object (Page 1909) 
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ProgID Property 


Description 
Returns the ProgID of an ActiveX Control. STRING read access. 


Example: 


In the following example the ActiveX Control "WinCC Gauge Control" is inserted in the active 
picture. The ProgID is then output: 


Sub AddActiveXControl () 

"VBA689 

Dim objActiveXControl As HMIActiveXControl 

Set objActiveXControl = ActiveDocument.HMIObjects.AddActivexXControl ("WinCC_ Gauge", 
"XGAUGE. XGaugeCtr1l.1") 

With ActiveDocument 

-HMIObjects ("WinCC_Gauge") .Top = 40 

-HMIObjects ("WinCC_ Gauge") .Left = 40 

sgBox "ProgID of ActiveX-control: " & .HMIObjects("WinCC Gauge") .ProgID 
End With 

End Sub 


See also 
ActivexXControl Object (Page 1900) 
AddActiveXControl Method (Page 1795) 


ProjectName Property 


Description 
Returns the project name. Read access. 
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Example: 


In this example the name and type of the loaded project will be output. 


Sub ShowProjectInfo() 

"VBA690 

Dim iProjectType As Integer 

Dim strProjectName As String 

Dim strProjectType As String 
iProjectType = Application.ProjectType 


strProjectName = Application.ProjectName 
Select Case iProjectTyp 
Case 0 
strProjectType = "Single-User System" 
Case 1 
strProjectType = "Multi-User System" 
Case 2 
strProjectType = "Client System" 
End Select 
sgBox "Projecttype: " & strProjectType & vbCrLf & "Projectname: " & strProjectName 
End Sub 
See also 
Application Object (Page 1909) 
ProjectType Property 
Description 


Returns the project type. Value range from 0 to 2. Read access. 


Project type Assigned Value 
Single-user project 0 
Multi-user project 1 
client project 2 
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Example: 


In this example the name and type of the loaded project will be output: 


Sub ShowProjectInfo() 


"VBA691 


Dim iProjectType As Integer 

Dim strProjectName As String 
Dim strProjectType As String 
iProjectType = 
strProjectName 


Application.ProjectType 
= Application. ProjectName 


Select Case iProjectTyp 
Case 0 
strProjectType = "Single-User System" 
Case 1 
strProjectType = "Multi-User System" 
Case 2 
strProjectType = "Client System" 
End Select 
sgBox "Projecttype: " & strProjectType & vbCrLf & "Projectname: " & strProjectName 
End Sub 
See also 


Application Object (Page 1909) 


Properties Property 


Description 


Example: 


2388 


Returns a Properties listing containing all the properties of the specified object. Read only 
access. 


To return an element from the Properties listing you can use either the index number or the 
name of the VBA property. 


You must use the Properties property if, for example, you wish to access the properties of 
objects located in a group object. 


Examples showing how to use the Properties property can be found in this documentation 
under the following headings: 


e "Editing Objects with VBA" 
e "Group objects" 


e "Customized Objects" 
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See also 
HMIObject Object (Page 1988) 
Customized Objects (Page 1682) 
Group Objects (Page 1674) 
Editing Objects with VBA (Page 1660) 
Prototype Property 
Description 
Returns the function heading of a script. The function heading is assigned by default if no 
source code is configured. 
Example: 


In the following example a button and a circle will be inserted in the active picture. In Runtime 
the radius of the circle will enlarge every time you click the button. In this case only the prototype 
of the VB script is output: 


Sub ExampleForPrototype () 


"VBA692 


Dim objButton As HMIButton 


Dim objC 


ircleA As HMICircle 


Dim objEvent As HMIEvent 
Dim objVBScript As HMIScriptInfo 


Set objc 


ircleA = ActiveDocument.HMIObjects.AddHMIObject ("CircleA", "HMICircle") 


Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMTButton") 
With objCircleA 


m 


op = 1 
-Left = 
End With 


00 
100 


With objButton 


-Top = 1 
-Left = 
-Width = 


Text = 


0 

10 

200 

"Increase Radius" 


End With 
"On ever 


y mouseclick the radius have to increase: 


Set objEvent = objButton.Events (1) 
Set objVBScript = objButton.Events(1).Actions.AddAction (hmiActionCreationTypeVBScript) 


End Sub 


See also 


sgBox objVBScript.Prototype 


ScriptInfo Object (Page 2058) 
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QualityCodeStateChecked Properties 


Description 
TRUE, if the quality code of the specified tag is used in Dynamic dialog for dynamization. 


BOOLEAN write-read access. 
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Example: 


In the following example the radius of a circle is given dynamics with the Dynamization uses 
the analysis of the quality code of a tag. If the tag fails to return a quality code, a substitute 
value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
"'VBA816 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD MISCSTATES = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = 110 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

.- VALUE LOWLIMITED = 140 

. VALUE _UNCERT ENGVHIGHLIM = 150 
. VALUE _UNCERT_ ENGVLOWLIM = 160 
- VALUE UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE UNCERT MAINTDEM = 190 
.VALUE_UNCERT_MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 


See also 
DynamicDialog Object (Page 1955) 
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QualityCodeStateValues Property 


Description 
Returns the QualityCodeStateValues listing. Use the QualityCodeStateValues property with 


the Item property to assign a value to the quality code status to be used for dynamization. 
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Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
"'VBA817 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


DynamicDialog Object (Page 1955) 
QualityCodeStateValues Object (Listing) (Page 2046) 
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R 
Radius Property 
Description 
Defines or returns the radius in the case of the following objects: 
@ Circle: Radius in pixels (0 to 10000) 
e@ CircularArc: Radius in pixels (0 to 10000) 
@ PieSegment: Radius in pixels (0 to 10000) 
@ RoundButton: Radius in pixels (0 to 10000) 
Example: 


The "PieSegmentConfiguration()" procedure accesses the properties of the Pie Segment. In 
this example the radius will be set to "80": 


Sub PieSegmentConfiguration () 

"VBA693 

Dim objPieSegment As HMIPieSegment 

Set objPieSegment = ActiveDocument.HMIObjects.AddHMIObject ("PieSegment1", "HMIPieSegment") 
With objPieSegment 

-StartAngle = 40 

-EndAngle = 180 

-Radius = 80 


End With 

End Sub 

See also 
RoundButton Object (Page 2052) 
PieSegment Object (Page 2032) 
CircularArc Object (Page 1931) 
Circle Object (Page 1928) 

RadiusHeight Property 

Description 


Defines or returns the vertical radius in pixels (0 to 5000) in the case of elliptical objects (Ellipse, 
EllipseArc, EllipseSegment). 
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Example: 


The "EllipseConfiguration()" procedure accesses the properties of the ellipse object. In this 
example the horizontal radius will be set to "60": 


Sub EllipseConfiguration () 


"VBA694 
Dim objEllipse As HMIEllipse 
Set objEllipse = ActiveDocument.HMIObjects.AddHMIObject ("Ellipsel", "HMIEllipse") 


With objEllipse 

-RadiusHeight = 60 
-RadiusWidth = 40 
End With 
End Sub 


See also 
RadiusWidth Property (Page 2395) 
EllipseSegment Object (Page 1963) 
EllipseArc Object (Page 1960) 
Ellipse Object (Page 1957) 


RadiusWidth Property 


Description 


Defines or returns the horizontal radius in pixels (0 to 5000) in the case of elliptical objects 
(Ellipse, EllipseArc, EllipseSegment). 


Example: 


The "EllipseConfiguration()" procedure accesses the properties of the ellipse object. In this 
example the horizontal radius will be set to "40": 


Sub EllipseConfiguration () 


"VBA695 
Dim objEllipse As HMIEllipse 
Set objEllipse = ActiveDocument.HMIObjects.AddHMIObject ("Ellipsel", "HMIEllipse") 


With objEllipse 

-RadiusHeight = 60 
-RadiusWidth = 40 
End With 
End Sub 
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See also 
RadiusHeight Property (Page 2394) 
EllipseSegment Object (Page 1963) 
EllipseArc Object (Page 1960) 
Ellipse Object (Page 1957) 
RangeTo Property 
Description 
Defines or returns the analog value range. 
Example: 
An example showing how to use the RangeTo property can be found in this documentation 
under the heading "AnalogResultInfos Object (Listing)". 
See also 


Value Property (Page 2469) 
AnalogResultInfos Object (Listing) (Page 1908) 
AnalogResultInfo Object (Page 1907) 


ReferenceRotationLeft Property 


Description 


Defines or returns the X-coordinate of the reference point about which the object should be 
rotated in Runtime. 


The value of the X-coordinate is relative to the object width. Enter the value in percent starting 
from the left edge of the rectangle enclosing the object. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
2396 System Manual, 02/2016, ASE37536061-AA 


VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


The "PolyLineConfiguration()" procedure accesses the properties of the PolyLine object. In 
this example, the coordinates of the reference point will be set to 50% of the object width and 
50% of the object height: 


Sub PolyLineConfiguration() 

"VBA696 

Dim objPolyLine As HMIPolyLine 

Set objPolyLine = ActiveDocument.HMIObjects.AddHMIObject ("PolyLinel", "“HMIPolyLine") 
With objPolyLine 

-ReferenceRotationLeft = 50 

.-ReferenceRotationTop = 50 

End With 

End Sub 


See also 
RotationAngle Property (Page 2400) 
ReferenceRotationTop Property (Page 2397) 
PolyLine Object (Page 2038) 
Polygon Object (Page 2035) 
Line Object (Page 2004) 


ReferenceRotationTop Property 


Description 


Defines or returns the Y-coordinate of the reference point about which the object should be 
rotated in Runtime. 


The value of the Y-coordinate is relative to the object width. Enter the value in percent starting 
from the top edge of the rectangle enclosing the object. 
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Example: 


The "PolyLineConfiguration()" procedure accesses the properties of the PolyLine object. In 
this example, the coordinates of the reference point will be set to 50% of the object width and 
50% of the object height: 


Sub PolyLineConfiguration() 

"'VBA697 

Dim objPolyLine As HMIPolyLine 

Set objPolyLine = ActiveDocument.HMIObjects.AddHMIObject ("PolyLinel", "HMIPolyLine") 
With objPolyLine 

-ReferenceRotationLeft = 50 

-ReferenceRotationTop = 50 

End With 

End Sub 


See also 
RotationAngle Property (Page 2400) 
ReferenceRotationLeft Property (Page 2396) 
PolyLine Object (Page 2038) 
Polygon Object (Page 2035) 
Line Object (Page 2004) 


Relevant Property 


Description 


TRUE when the "GroupDisplay", "AdvancedAnalogDisplay" or "AdvancedStateDisplay" object 
is taken into account when forming the group display. BOOLEAN write-read access. 


Example 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example the object for forming the group display will be considered: 


Sub GroupDisplayConfiguration() 

"VBA698 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMTGroupDisplay") 

With objGroupDisplay 

-Relevant = Tru 

End With 

End Sub 
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See also 
Group Object (Page 1978) 
ResultType Property 
Description 
Defines or returns the value range evaluation type in the Dynamic dialog. 
Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog, a tag name will be assigned and the associated property values will be assigned to 
both the binary value ranges: 


Sub AddDynamicDialogToCircleRadiusTypeBinary () 
"VBA699 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle C", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""'NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeBool 


.BinaryResultInfo.NegativeValue = 20 
.BinaryResultInfo.PositiveValue = 40 
End With 

End Sub 

See also 


DynamicDialog Object (Page 1955) 


RightComma Property 


Description 


Defines or returns the number of decimal places (0 to 20) for the BarGraph object. 
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Example: 


The "BarGraphConfiguration()" procedure configures In this example the number of decimal 
places will be limited to 4. 


Sub BarGraphConfiguration () 

"VBA700 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

-RightComma = 4 


End With 
End Sub 
See also 
BarGraph Object (Page 1914) 
RotationAngle Property 
Description 


Line, Polygon and PolyLine 


Defines or returns the rotation angle of the following objects in degrees: Line, Polygon, 
PolyLine. 


The object is displayed in Runtime only rotated clockwise around the reference point by the 
specified value (starting from the configured starting position). 


T-piece 


Defines or returns the orientation of a T-piece in degrees. The attribute can only assume one 
of four values: 


0 The standard position of the T-piece is the shape of the letter "T" 
90 The "leg" of the "T" points towards the left 

180 The "leg" of the "T" points upwards 

270 The "leg" of the "T" points to the right 


Other values are automatically converted to modulus 360 and rounded up or down to the 
nearest permissible value. 


The T-piece is shown rotated around the center point in the project and in Runtime. 
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Example: 


The "PolyLineConfiguration()" procedure accesses the properties of the PolyLine object. In 
this example the object will be rotated by 45° in Runtime: 


Sub PolyLineConfiguration () 

"VBA701 

Dim objPolyLine As HMIPolyLine 

Set objPolyLine = ActiveDocument.HMIObjects.AddHMIObject ("PolyLinel", "HMIPolyLine") 
With objPolyLine 

-ReferenceRotationLeft = 50 

-ReferenceRotationTop = 50 

-RotationAngle = 45 

End With 

End Sub 


See also 
ReferenceRotationTop Property (Page 2397) 
ReferenceRotationLeft Property (Page 2396) 
PolyLine Object (Page 2038) 
Polygon Object (Page 2035) 
Line Object (Page 2004) 


RoundCornerHeight Property 
Description 


Defines or returns the corner radius of the RoundRectangle object. 


Enter the value as a percentage of half the height of the object. 
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Example: 


The "RoundRectangleConfiguration()" procedure accesses the properties of the object 
RoundRectangle. In this example the corner radius will be set to 25% (height) and 50% (width). 


Sub RoundRectangleConfiguration() 


"VBA702 

Dim objRoundRectangle As HMIRoundRectangle 

Set objRoundRectangle = ActiveDocument.HMIObjects.AddHMIObject ("RoundRectanglel", 
"HMTRoundRectangle") 


With objRoundRectangle 

-RoundCornerHeight = 25 
-RoundCornerWidth = 50 

End With 

End Sub 


See also 
RoundCornerWidth Property (Page 2402) 
RoundRectangle Object (Page 2055) 


RoundCornerWidth Property 
Description 
Defines or returns the corner radius of the RoundRectangle object. 


Enter the value as a percentage of half the width of the object. 


Example: 


The "RoundRectangleConfiguration()" procedure accesses the properties of the object 
RoundRectangle. In this example the corner radius will be set to 25% (height) and 50% (width): 


Sub RoundRectangleConfiguration() 


'VBA703 

Dim objRoundRectangle As HMIRoundRectangle 

Set objRoundRectangle = ActiveDocument.HMIObjects.AddHMIObject ("RoundRectanglel", 
"HMTRoundRectangle") 


With objRoundRectangle 

-RoundCornerHeight = 25 
-RoundCornerWidth = 50 

End With 

End Sub 
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See also 
RoundCornerHeight Property (Page 2401) 
RoundRectangle Object (Page 2055) 


SameSize Property 


Description 


TRUE, when all four buttons of a Group Display object have the same size. BOOLEAN write- 
read access. 


Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example all four buttons will have the same size. 


Sub GroupDisplayConfiguration() 

'VBA704 

Dim objGroupDisplay As HMIGroupDisplay 

Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMTGroupDisplay") 

With objGroupDisplay 

-SameSize = True 

End With 

End Sub 


See also 
GroupDisplay Object (Page 1980) 


ScaleColor Property 


Description 
Defines or returns the color of the scale. LONG write-read access. 


The "Scaling" property must be set to TRUE for the color to be displayed. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
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Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 


represented as follows: RGB(255, 0, 0) 


Example: 


The "BarGraphConfiguration()" procedure configures In this example the scale will be 


displayed and the scale color will be set to "Red": 


Sub BarGraphConfiguration() 


"VBA705 


Dim objBarGraph As HMIBarGraph 


Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "“HMIBarGraph") 


With objBarGraph 
-Scaling = True 


-ScaleColor = RGB(255, 


End With 
End Sub 


See also 


Scaling Property (Page 2405) 
BarGraph Object (Page 1914) 


ScaleTicks Property 


Description 


0, 


0) 


Defines or returns the number of scale sections for the BarGraph object. 


A scale section is a part of the scale bounded by two long scale strokes or division ticks. If you 
assign a value of "0" to the property, the appropriate scale marks will be calculated 
automatically. 


Example: 


The "BarGraphConfiguration()" procedure configures In this example the number of scale 


sections will be set to "10". 


Sub BarGraphConfiguration() 


"VBA706 


Dim objBarGraph As HMIBarGraph 


Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 


With objBarGraph 
-Scaling = True 

-ScaleTicks = 10 
End With 

End Sub 


2404 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


VBA for Automated Configuration 
3.6 VBA Reference 


See also 
BarGraph Object (Page 1914) 


Scaling Property 


Description 


TRUE if a scale is also used to display the values in the case of the BarGraph object. BOOLEAN 
write-read access. 


Example: 


The "BarGraphConfiguration()" procedure configures the properties of the BarGraph object. 
In this example the scale will be displayed and the scale color will be set to "Red": 


Sub BarGraphConfiguration() 

"VBA707 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

-Scaling = True 

-ScaleColor = RGB(255, 0, O) 

End With 

End Sub 


See also 
BarGraph Object (Page 1914) 


ScalingMode property 


Description 


Defines the size to display the objects of the faceplate instance. 


Default Like scaling mode "proportional" 


1:1 The faceplate type is displayed in the original size in the faceplate instance. If 
the faceplate instance is too small, the size of the faceplate instance is adapted 
to the size of the faceplate type. 


Proportional The faceplate type is scaled in proportion with the size of the faceplate instance. 
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Example 


ScalingType Property 


Description 
Defines or returns the type of bar scaling. Value range from 0 to 2. 
The "Scaling" property must be set to TRUE for the color to be displayed. 
Bar Scaling Assigned Value 
Linear 0 
Logarithmic 1 
Automatic 2 
Example: 


The "BarGraphConfiguration()" procedure configures In this example the bar scaling will be 


set to "Linear": 


Sub BarGraphConfiguration() 
'VBA708 
Dim objBarGraph As HMIBarGraph 


Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 


With objBarGraph 
-ScalingType = 0 
-Scaling = True 


End With 
End Sub 
See also 
Scaling Property (Page 2405) 
BarGraph Object (Page 1914) 
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Description 
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Returns the script type (C or VBS) which was used to make a property or event dynamic. Read 


only access. 


Example: 
In the following example a button and a circle will be inserted in the active picture. In Runtime 
the radius of the circle will enlarge every time you click the button. In this case the script type 
will be output: 
Sub ExampleForPrototype () 
"VBA709 
Dim objButton As HMIButton 


Dim 
Dim 
Dim 
Dim 
Set 
set 
Wit 
.Le 
End 
Wit 


‘i 


.Le 
Wi 


m 


objCircleA As HMICircle 

objEvent As HMIEvent 

objVBScript As HMIScriptInfo 

strScriptType As String 

objCircleA = ActiveDocument.HMIObjects.AddHMIObject ("CircleA", 
objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", 
h objCircleA 


op = 100 


ft = 100 
With 
h objButton 


-Top = 10 


ft = 10 
dth = 200 
xt = "Increase Radius" 


End 
"On 
Set 
Set 
Sel 
Cas 
SLY 
Cas 
str 
End 
Sg 
End 


See 


WinC 


With 
every mouseclick the radius have to increase: 
objEvent = objButton.Events (1) 


"HMTCircle") 
"HMTButton") 


objVBScript = objButton.Events(1).Actions.AddAction (hmiActionCreationTypeVBScript) 


ect Case objVBScript.ScriptType 

e 0 

Script! 

el 

Script! 
Select 

Box strScriptType 
Sub 


n 


ype = "VB script is used" 


n 


ype = "C-Skript is used" 


also 
Scriptinfo Object (Page 2058) 
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ScrollBars Property 


Description 


TRUE if the picture window has scroll bars in Runtime. BOOLEAN write-read access. 


Example: 


The "PictureWindowConfig" procedure accesses the properties of the picture window. In this 
example the picture window will be configured: 


Sub PictureWindowConfig() 

'VBA710 

Dim objPicWindow As HMIPictureWindow 

Set objPicWindow = ActiveDocument.HMIObjects.AddHMIObject ("PicWindow1l", "HMIPictureWindow") 
With objPicWindow 

-AdaptPicture = False 

-AdaptSize = False 

-Caption = True 


-CaptionText = "Picturewindow in runtime" 
-OffsetLeft = 5 

-OffsetTop = 10 

"Replace the picturename "Test.PDL" with the name of 
‘an existing document from your "GraCS"-Folder of your active project 
.-PictureName = "Test.PDL" 

-ScrollBars = True 

.ServerPrefix = ™" 

-TagPrefix = "Struct." 

-UpdateCycle = 5 

-Zoom = 100 

End With 

End Sub 


See also 
PictureWindow Object (Page 2029) 


ScrollPositionX Property 


Description 


Specifies the horizontal positioning of the scroll bar in a picture window with slider, or returns 
its value. 
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Example: 


The "PictureWindowConfig" procedure accesses the properties of the picture window. In this 
example the picture window will be configured: 


Sub PictureWindowConfig() 

"'VBA808 

Dim objPicWindow As HMIPictureWindow 

Set objPicWindow = ActiveDocument.HMIObjects.AddHMIObject ("PicWindow1l", "HMIPictureWindow") 
With objPicWindow 

-AdaptPicture = False 

-AdaptSize = False 

-Caption = True 


-CaptionText = "Picturewindow in runtime" 
-OffsetLeft = 5 

-OffsetTop = 10 

"Replace the picturename "Test.PDL" with the name of 
‘an existing document from your "GraCS"-Folder of your active project 
.-PictureName = "Test.PDL" 

-ScrollBars = True 

-ScrollPositionxX = 50 

-ScrollPositionY = 50 

.ServerPrefix = ™" 

-TagPrefix = "Struct." 

-UpdateCycle = 5 

-Zoom = 100 

End With 

End Sub 


See also 
PictureWindow Object (Page 2029) 


ScrollPositionY Property 


Description 


Specifies the vertical positioning of the scroll bar in a picture window with slider, or returns its 
value. 
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Example: 


The "PictureWindowConfig" procedure accesses the properties of the picture window. In this 
example the picture window will be configured: 


Sub PictureWindowConfig() 
"VBA809 
Dim objPicWindow As HMIPictureWindow 


Set objPicWindow = ActiveDocument.HMIObjects.AddHMIObject ("PicWindowl", 


With objPicWindow 
-AdaptPicture = False 
-AdaptSize = False 
-Caption = True 
-CaptionText = 
-OffsetLeft = 5 
-OffsetTop = 10 
"Replace the picturename "Test.PDL" with the name 
‘an existing document from your "GraCS"-Folder of 
-PictureName = "Test.PDL" 


"Picturewindow in runtime" 


-ScrollBars = True 
-ScrollPositionxX = 50 
-ScrollPositionYy = 50 
.ServerPrefix = "™" 
-TagPrefix = "Struct." 
-UpdateCycle = 5 
-Zoom = 100 
End With 
End Sub 
See also 


PictureWindow Object (Page 2029) 


ScrollPosX Property 


Description 


"HMI PictureWindow") 


of 
your active project 


Defines or returns the X position of the scroll bars for the View object. 


2410 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example a copy of the active picture is created and then activated. The position 
of the scroll bars will be set to 40 (X) and 10 (Y): 


Sub CreateViewAndActivateView() 

Dim objView As HMIView 

Set objView = ActiveDocument.Views.Add 
objView.Activate 

objView.ScrollPosx = 40 
objView.ScrollPosY = 10 

End Sub 


See also 
ScrollPosY Property (Page 2411) 
View Object (Page 2102) 


ScrollPosY Property 


Description 
Defines or returns the Y position of the scroll bars for the View object. 


Example: 


In the following example a copy of the active picture is created and then activated. The position 
of the scroll bars will be set to 40 (X) and 10 (Y): 


Sub CreateViewAndActivateView() 

Dim objView As HMIView 

Set objView = ActiveDocument.Views.Add 
objView.Activate 

objView.ScrollPosx = 40 
objView.ScrollPosY = 10 

End Sub 


See also 
ScrollPosX Property (Page 2410) 
View Object (Page 2102) 
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SelBGColor Property 


Description 
Defines or returns the background color for the selected entry in the case of the TextList object. 
LONG write-read access. 
Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


Example: 


The "TextListConfiguration()" procedure accesses the properties of the object TextList. In this 
example the background color for the selected entry will be set to "Red": 


Sub TextListConfiguration() 
Dim objTextList As HMITextList 


"Neue TextListe ins aktuelle Bild einftigen: 

Set objTextList = ActiveDocument.HMIObjects.AddHMIObject ("myTextList", "HMITextList") 
With objTextList 

-SelBGColor = RGB (255, 0, 0) 

End With 

End Sub 


See also 
TextList Object (Page 2076) 


Selected Property 


Description 
TRUE if an object is selected in the picture. BOOLEAN write-read access. 
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Example: 
In the following example two new objects will be inserted in the active picture and then selected: 


Sub SelectObjects () 

"VBA714 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 

Dim objGroup As HMIGroup 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "“HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SRectangle", "HMIRectangle") 
With objCircle 

-Top = 40 

-Left = 40 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 80 

-Selected = Tru 

End With 

sgBox "Objects selected!" 

End Sub 


See also 
HMIObject Object (Page 1988) 


Selection Property 


Description 
Returns a listing containing all the objects selected in the specified picture. 
To return an element from the Selection listing you can use either the index number or the 
object name. 
You can use the Selection property, for example, to select all the objects in the picture. 
Example: 


In the following example all the objects in the active picture are selected: 


Sub SelectAllObjectsInActiveDocument () 
"VBA715 
ActiveDocument.Selection.SelectAll 
End Sub 
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See also 


SelectedObjects object (Listing) (Page 2060) 
Document Object (Page 1949) 


Sellndex property 


Description 
Defines or returns the index of which the associated text is highlighted in the combobox or list 
box. 
SelText property 
Description 
Shows the text defined with the "Sellndex" property which is highlighted in the ComboBox or 
ListBox object. You cannot directly change the "Selected text" attribute. You change the 
"Selected text" attribute by changing the "Selected box" attribute or the text itself in the "Font" 
properties group. 
SelTextColor Property 
Description 
Defines or returns the text color for the selected entry in the TextList object. LONG write-read 
access. 
Determination of Color Value 
The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 
Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
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Example: 


The "TextListConfiguration()" procedure accesses the properties of the object TextList. In this 
example the text color for the selected entry will be set to "Yellow": 


Sub TextListConfiguration () 

"VBA716 

Dim objTextList As HMITextList 

Set objTextList = ActiveDocument.HMIObjects.AddHMIObject ("myTextList", "HMITextList") 
With objTextList 

-SelTextColor = RGB(255, 255, 0) 

End With 

End Sub 


See also 
TextList Object (Page 2076) 


ServerName Property 


Description 


Returns the name of the specified ActiveX Control or of the embedded object. Read only 
access. 


Example 


In the following example the ActiveX Control "WinCC Gauge Control" will be inserted in the 
active picture and the name of the ActiveX Control will be output: 


Sub AddActiveXControl () 

"VBA717 

Dim objActiveXControl As HMIActiveXControl 
Set objActiveXControl = ActiveDocument .HMIObjects.AddActivexXControl ("WinCC_ Gauge", 
"XGAUGE. XGaugeCtr1l.1") 

With objActiveXControl 

-Top = 40 

-Left = 60 

sgBox .Properties ("ServerName") .value 

End With 

End Sub 


See also 
ActiveXControl Object (Page 1900) 
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ServerPrefix Property 


Description 


Defines the server which will hold the picture that is displayed in the picture window in Runtime, 
or returns the name of the server. 


Enter the server name followed by two colons: "<Servername>::". No check is made as to 
whether the server actually exists. 


Example: 


The "PictureWindowConfig" procedure accesses the properties of the picture window. In this 
example the picture window will be configured: 


Sub PictureWindowConfig() 

'VBA718 

Dim objPicWindow As HMIPictureWindow 

Set objPicWindow = ActiveDocument.HMIObjects.AddHMIObject ("PicWindowl", "HMIPictureWindow") 
With objPicWindow 

-AdaptPicture = False 

-AdaptSize = False 

-Caption = True 


-CaptionText = "Picturewindow in runtime" 
-OffsetLeft = 5 

-OffsetTop = 10 

"Replace the picturename "Test.PDL" with the name of 
‘an existing document from your "GraCS"-Folder of your active project 
.-PictureName = "Test.PDL" 

-ScrollBars = True 

.ServerPrefix = "my Server::" 

-TagPrefix = "Struct." 

-UpdateCycle = 5 

-Zoom = 100 

End With 

End Sub 


See also 
PictureWindow Object (Page 2029) 


ShortCut Property 


Description 


Defines or returns a shortcut key sequence for a user-defined menu entry or user-defined icon. 
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The following keys are permitted in combination with <CTRL>, <ALT> and <SHIFT>: 
e Function keys <F1> to <F12> 
e The letter keys <A> to <Z> and the number keys <0> to <9>. 


The following are not supported: the keys on the alphanumeric keypad, the cursor keys (e.g. 

<Page Up>) and the remaining function keys such as <RETURN> and <ESC>. No distinction 

is made upper and lower case. Key combinations with two or more letters or numbers are not 
permitted, such as "CTRL+A+B", but the combination with two additional keys such as <CTRL 
+ALT+A" is allowed. 


Notes on using the ShortCut property 


The key sequences used must be unique within the user-defined menus and toolbars in a 
picture. Key sequences that you configure with VBA have priority over any key sequences that 
may be present in the Graphics Designer. Within the user-defined menus and toolbars, picture- 
specific key sequences have priority over application-specific key sequences. 


Note 


Shortcut key sequences are only executed if the menu entry or the icon is visible and active. 
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Example: 


In the following example, a user-defined menu with two menus entries and a submenu with 
two entries will be created in the active picture. The submenu will be visually distinguished by 
a dividing line. The first menu entry receives the shortcut key sequence <CTRL+SHIFT+M> 
for retrieval: 


Sub CreateDocumentMenus () 
"VBA719 
Dim objDocMenu As HMIMenu 

Dim objMenuItem As HMIMenuItem 
Dim objSubMenu As HMIMenuItem 


‘Add menu to menubar: 


Set objDocMenu = ActiveDocument.CustomMenus.InsertMenu(1, "DocMenul", "Doc Menu_1") 
' 


‘Add menuitems to the new menu: 
Set objMenuItem = objDocMenu.Menultems.InsertMenultem(1, "dmIteml_ 1", "&My first Menuitem") 
Set objMenuItem = objDocMenu.Menultems.InsertMenultem(2, "dmIteml 2", "My second Menuitem") 


"Add seperator to menu: 
Set objMenuItem = objDocMenu.Menultems.InsertSeparator (3, "dSeparatorl 3") 


"Add submenu to the menu: 
Set objSubMenu = objDocMenu.MenulItems.InsertSubMenu(4, "dSubMenul 4", "My first submenu") 


‘Add menuitems to the submenu: 
Set objMenuItem = objSubMenu.SubMenu.InsertMenultem(5, "dmIteml 5", "My first submenuitem") 
Set objMenultem = objSubMenu.SubMenu.InsertMenultem(6, "dmIteml 6", "My second 


submenuitem") 
' 


ActiveDocument.CustomMenus ("DocMenul") .MenuItems(1).ShortCut = "CTRL+SHIFT+M" 
End Sub 


See also 
Configuring Menus and Toolbars (Page 1626) 
Toolbarltem Object (Page 2083) 
Menultem Object (Page 2013) 


ShowBadTagState property 


Description 


Determines if the object is grayed out when a bad quality code or tag status is detected. At 
both objects, "HMlAdvancedAnalogDisplay" and "HMlAdvancedStateAnalogDisplay", the 
property is used to specify whether the settings for the "PaintColor_QualityCodeBad" and 
"PaintColor_QualityCodeUnCertain" properties are used. 
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SignificantMask Property 


Description 


Needed in Runtime for displaying the active message class with the highest priority in the 
GroupDisplay object. 


The value of the SignificantMask property represents an internal system output value does not 
require any specific configuration by the user. Updating takes place in Runtime by clicking on 
the object. 


Example: 


See also 
GroupDisplay Object (Page 1980) 


Simulation property 


Description 
Specifies the interconnection with any tag that is used for simulation. 
SimulationBit property 
Description 
Shows the bit position of the linked simulation tags that is used for evaluation. 
The value of the simulation tag is only evaluated with the alarm status "OK". 
Size Property 
Description 


Defines or returns the font size in points for a language-dependent font. 
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Example: 


The following example sets the font attributes of a button for French and English: 


Sub ExampleForLanguageFonts () 
"VBA721 

Dim colLangFonts As HMILanguageFonts 
Dim objButton As HMIButton 


Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMTButton") 


objButton.Text = "DefText" 

Set colLangFonts = objButton.LDFonts 
' 

"Set font-properties for french: 
With colLangFonts.ItemByLCID (1036) 
-Family = "Courier New" 

-Bold = True 

-Italic = False 

.Underlined = Tru 

-Size = 12 

End With 


"Set font-properties for english: 
With colLangFonts.ItemByLCID (1033) 
.-Family = "Times New Roman" 

-Bold = False 

-Italic = True 

.Underlined = Fals 

-Size = 14 

End With 

End Sub 


See also 
Underlined Property (Page 2460) 
Parent Property (Page 2359) 
LanguagelD Property (Page 2289) 
Italic Property (Page 2282) 
Family Property (Page 2229) 
Bold Property (Page 2151) 
Application Property (Page 2121) 
LanguageFont Object (Page 1996) 
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Sizeable Property 


Description 


TRUE if the size of the ApplicationWindow and PictureWindow objects can be changed in 
Runtime. BOOLEAN write-read access. 


Example: 


The "ApplicationWindowConfig" procedure accesses the properties of the application window. 
In this example it is intended that the application window can be resized in Runtime: 


Sub ApplicationWindowConfig() 

"VBA722 

Dim objAppWindow As HMIApplicationWindow 

Set objAppWindow = ActiveDocument.HMIObjects.AddHMIObject ("AppWindow1", 
"HMIApplicationWindow") 

With objAppWindow 

-Sizeable = True 

End With 

End Sub 


See also 
PictureWindow Object (Page 2029) 
ApplicationWindow Object (Page 1911) 


SmallChange Property 


Description 


Defines how many steps the controller can be moved with one mouse click or returns the value. 


Example: 


The "SliderConfiguration()" procedure accesses the properties of the slider. In this example 
the number of steps will be set to "4": 


Sub SliderConfiguration() 

'VBA723 

Dim objSlider As HMISlider 

Set objSlider = ActiveDocument.HMIObjects.AddHMIObject ("SliderObject1i", "HMISlider") 
With objSlider 

-SmallChange = 4 

End With 

End Sub 
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See also 
Slider object (Page 2062) 


SnapToGrid Property 


Description 


TRUE if objects in the picture are aligned on the grid (which is invisible). BOOLEAN write-read 
access. 


Example: 


In the following example, the alignment of objects in the active picture on the grid is activated: 


Sub ActivateSnapToGrid () 


"VBA724 
ActiveDocument.SnapToGrid = True 
End Sub 
See also 
Document Object (Page 1949) 
SourceLink Property 
Description 
Returns the Source object. Use the SourceLink property to configure the source object in the 
case of a direct connection. 
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Sub Direct 
"VBA725 

Dim objBut 
Dim objRec 
Dim objRec 


3.6 VBA Reference 


In the following example the X position of "Rectangle_A" is copied to the Y position of 


"Rectangle_B" in Runtime by clicking on the button: 


Connection () 


ton As HMIButton 

tangleA As HMIRectangle 

tangleB As HMIRectangle 

nt As HMITEvent 

Connection As HMIDirectConnection 


op = 100 


With objRe 
-Top = 250 
-Left = 40 
-BackColor 
End With 
With ob jBu 
-Top = 10 
-Left = 10 
-Width = 1 
-Text = "S 
End With 

' 


"Directcon 
Set objDir 
objButton. 
With objDi 


ctangleA 


ctangleB 


0) 
= RGB(255, 0, 0) 


tton 


00 
etPosition" 


nection is initiated by mouseclick: 
Connection = 


rConnection 


"Sourceobject: Property "Top" of Rectangle A 


-SourceLin 
-SourceLin 


-SourceLin 
' 


k.Type = hmiSourceTypeProperty 
k.ObjectName = "Rectangle A" 
k.AutomationName = "Top" 


'Targetobject: Property "Left" of Rectangle B 
.DestinationLink.Type = hmiDestTypeProperty 
.DestinationLink.ObjectName = "Rectangle B" 
.DestinationLink.AutomationName = "Left" 

End With 

End Sub 
See also 


Type Property (Page 2450) 
ObjectName Property (Page 2347) 
AutomationName Property (Page 2124) 
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tangleA = ActiveDocument .HMIObjects.AddHMIObject ("Rectangle A", "HMIRectangle") 


tangleB = ActiveDocument .HMIObjects.AddHMIObject ("Rectangle B", "HMIRectangle") 
ton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMIButton") 


Events (1) .Actions.AddAction (hmiActionCreationTypeDirectConnection) 
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SourceLink Object (Page 2065) 
DirectConnection Object (Page 1947) 


SourceCode Property 


Description 
Defines or returns the source code of a C script or VB script. 


If you assign a C script to the SourceCode property, you must enter only the program code 
located between the braces ("{}"). 


If you assign a VB script to the SourceCode property, you must enter only the program code 
located between the Sub and EndSub keywords. 


Note 


If you use single quote marks (') or double quote marks (") in the program code, you must enter 
an additional quote mark in front of every single or double quote mark so that the program 
code can be correctly interpreted in the VBA editor. 


The Compiled property returns TRUE if the source code was successfully compiled. 
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Example: 


In the following example a button and a circle will be inserted in the active picture. In Runtime 
the radius of the circle will enlarge every time you click the button. A VB script will be used for 


this purpose: 


Sub IncreaseCircleRadiusWithVBScript () 

"VBA726 

Dim objButton As HMIButton 

Dim objCircleA As HMICircle 

Dim objEvent As HMIEvent 

Dim objVBScript As HMIScriptInfo 

Dim strCode As String 

strCode = "Dim objCircle" & vbCrLf & "Set objCircle = " 

strCode = strCode & "hmiRuntime.ActiveScreen.ScreenItems (""CircleVB"™")" 

strCode = strCode & vbCrLf & "objCircle.Radius = objCircle.Radius + 5" 

Set objCircleA = ActiveDocument.HMIObjects.AddHMIObject ("CircleVB", "HMICircle") 
Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMTButton") 
With objCircleA 


-Top = 100 

.-Left = 100 

End With 

With objButton 

-Top = 10 

-Left = 10 

-Width = 200 

-Text = "Increase Radius" 
End With 


"On every mouseclick the radius have to increase: 
Set objEvent = objButton.Events (1) 

Set objVBScript = objButton.Events(1).Actions.AddAction (hmiActionCreationTypeVBScript) 
objVBScript.SourceCode = strCode 

Select Case objVBScript.Compiled 

Case True 

sgBox "Compilation ok!" 

Case False 

sgBox "Error on compilation!" 

End Select 

End Sub 


See also 
Compiled Property (Page 2197) 
ScriptInfo Object (Page 2058) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 


2425 


VBA for Automated Configuration 
3.6 VBA Reference 


StartAngle Property 


Description 
Defines or returns the start of the object for the CircularArc, EllipseArc, EllipseSegment and 
PieSegment objects. The information is in counterclockwise direction in degrees, beginning at 
the 12:00 clock position. 


Example: 


The "PieSegmentConfiguration()" procedure accesses the properties of the Pie Segment. In 
this example the pie segment begins at 40° and ends at 180°: 


Sub PieSegmentConfiguration () 

"VBA727 

Dim PieSegment As HMIPieSegment 

Set PieSegment = ActiveDocument.HMIObjects.AddHMIObject ("PieSegment1", "HMIPieSegment") 
With PieSegment 

-StartAngle = 40 

-EndAngle = 180 


End With 

End Sub 

See also 
EndAngle Property (Page 2222) 
PieSegment Object (Page 2032) 
EllipseSegment Object (Page 1963) 
EllipseArc Object (Page 1960) 
CircularArc Object (Page 1931) 

Status Text Property 

Description 


Defines or returns the text that will be displayed in the status bar when you point with the mouse 
to a user-defined menu entry or user-defined icon. 
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Example: 


In the following example, a user-defined menu with two menus entries and a submenu with 
two entries will be created in the active picture. The submenu will be visually distinguished by 
a dividing line. A status bar entry will be defined for each menu entry: 


Sub CreateDocumentMenus () 
'VBA728 
Dim objDocMenu As HMIMenu 

Dim objMenuItem As HMIMenuItem 
Dim objSubMenu As HMIMenuItem 
' 

"Add menu: 


Set objDocMenu = ActiveDocument.CustomMenus.InsertMenu(1, "DocMenul", "Doc Menu_1") 
' 


‘Add menuitems to custom-menu: 
Set objMenuItem = objDocMenu.Menultems.InsertMenultem(1, "dmIteml_ 1", "My first menuitem") 
Set objMenultem = objDocMenu.Menultems.InsertMenultem(2, "dmIteml 2", "My second menuitem") 


"Add seperator to custom-menu: 
Set objMenultem = objDocMenu.Menultems.InsertSeparator (3, "dSeparatorl 3") 


"Add submenu to custom-menu: 
Set objSubMenu = objDocMenu.MenulItems.InsertSubMenu(4, "dSubMenul 4", "My first submenu") 


‘Add menuitems to submenu: 
Set objMenulItem = objSubMenu.SubMenu.InsertMenultem(5, "dmIteml_ 5", "My first submenuitem") 
Set objMenuItem = objSubMenu.SubMenu.InsertMenultem(6, "dmIteml 6", "My second 


submenuitem") 
' 


"Assign statustexts to every menuitem 
With objDocMenu 


-MenulItems(1).StatusText = "My first menuitem" 

-Menultems (2).StatusText = "My second menuitem" 

-Menultems (4) .SubMenu.Item(1).StatusText = "My first submenuitem" 
-Menultems (4) .SubMenu.Item(2).StatusText = "My second submenuitem" 
End With 

End Sub 

See also 


Toolbarltem Object (Page 2083) 
Menultem Object (Page 2013) 


SubMenu Property 
Description 
Returns a Menultems listing if the specified object is the "SubMenu" type. 


Use the SubMenu listing if you wish to create a submenu in a user-defined menu. 
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Example: 


In the following example, a user-defined menu with two menus entries and a submenu with 
two entries will be created in the active picture. The submenu will be visually distinguished by 
a dividing line: 


Sub CreateDocumentMenus () 
"VBA730 
Dim objDocMenu As HMIMenu 

Dim objMenuItem As HMIMenuItem 
Dim objSubMenu As HMIMenuItem 


"Add menu: 


Set objDocMenu = ActiveDocument.CustomMenus.InsertMenu(1, "DocMenul", "Doc Menu_1") 
' 


‘Add menuitems to custom-menu: 
Set objMenultem = objDocMenu.Menultems.InsertMenultem(1, "dmIteml 1", "My first menuitem") 
Set objMenuItem = objDocMenu.Menultems.InsertMenultem(2, "dmIteml 2", "My second menuitem") 


"Add seperator to custom-menu: 
Set objMenuItem = objDocMenu.Menultems.InsertSeparator (3, "dSeparatorl 3") 


"Add submenu to custom-menu: 
Set objSubMenu = objDocMenu.MenulItems.InsertSubMenu(4, "dSubMenul 4", "My first submenu") 


‘Add menuitems to submenu: 

Set objMenulItem = objSubMenu.SubMenu.InsertMenultem(5, "dmIteml_ 5", "My first submenuitem") 
Set objMenultem = objSubMenu.SubMenu.InsertMenultem(6, "dmIteml 6", "My second 
submenuitem") 


End Sub 
See also 
Menultem Object (Page 2013) 
SymbolLibraries Property 
Description 


Returns a SymbolLibraries listing containing objects of the "SymbolLibrary" type. 


Use SymbolLibraries(1) to return the "Global Library". Use SymbolLibraries(2) to return the 
"Project Library". 


WinCC: Scripting (VBS, ANSI-C, VBA) 
2428 System Manual, 02/2016, ASE37536061-AA 


VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the names of the libraries will be output: 


Sub ShowSymbolLibraries() 
'VBA731 
Dim colSymbolLibraries As HMISymbolLibraries 

Dim objSymbolLibrary As HMISymbolLibrary 

Set colSymbolLibraries = Application.SymbolLibraries 
For Each objSymbolLibrary In colSymbolLibraries 
sgBox objSymbolLibrary.Name 

ext objSymbolLibrary 


End Sub 
See also 
Application Object (Page 1909) 
T 
TabOrderAlpha Property 
Description 


Defines or returns the position of the object in the TAB sequence for the alpha / tab order 
cursor. 
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Example: 


In this example two I/O fields will be inserted in the active picture and the TAB sequence will 


then be defined: 


Sub I0FieldConfig() 

"'VBA734 

Dim objIOFieldl As HMIIOField 
Dim objIOField2 As HMIIOField 


Set obj1IOFieldl = ActiveDocument .HMIObjects.AddHMIObject ("IOFieldi", "HMIIOField") 
Set obj1IOField2 = ActiveDocument.HMIObjects.AddHMIObject ("IOField2", "HMIIOField") 


With objIOFieldl 
-Top = 10 

-Left = 10 
-TabOrderAlpha = 1 
End With 

With objIOField2 
-Top = 100 

-Left = 10 
.TabOrderAlpha = 2 
End With 

End Sub 


See also 


Document Object (Page 1949) 


TabOrderAllHMlObjects Property 


Description 


TRUE if all the objects in a picture are to be included in the configured TAB sequence. 


BOOLEAN write-read access. 
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Example: 


3.6 VBA Reference 


The "ConfigureTabOrder()" procedure defines which objects in the active picture are to be 
included in the configured TAB sequence. In this example all the objects will be included in 


the TAB sequence: 


Sub ConfigureTabOrder () 
'VBA733 

With ActiveDocument 
.TABOrderAllHMIObjects = True 
.TABOrderKeyboard = False 


.TABOrderMouse = Fals 
-TABOrderOtherAction = False 
End With 

End Sub 

See also 


TabOrderOtherAction Property (Page 2432) 
TabOrderMouse Property (Page 2432) 
TabOrderKeyboard Property (Page 2431) 
Document Object (Page 1949) 


TabOrderKeyboard Property 


Description 


TRUE if objects with a keyboard operation event configured to them are to be included in the 
configured TAB sequence. BOOLEAN write-read access. 


Example: 


The "ConfigureTabOrder()" procedure defines which objects in the active picture are to be 
included in the configured TAB sequence. In this example objects with a keyboard operation 


will be included in the TAB sequence: 


Sub ConfigureTabOrder () 
"VBA735 

With ActiveDocument 
.TABOrderAllHMIObjects = True 
.TABOrderKeyboard = False 


.TABOrderMouse = Fals 
-TABOrderOtherAction = False 
End With 

End Sub 
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See also 
TabOrderOtherAction Property (Page 2432) 
TabOrderMouse Property (Page 2432) 
TabOrderAllHMlObjects Property (Page 2430) 
Document Object (Page 1949) 
TabOrderMouse Property 
Description 
TRUE if objects with a mouse operation event configured to them are to be included in the 
configured TAB sequence. BOOLEAN write-read access. 
Example: 


The "ConfigureTabOrder()" procedure defines which objects in the active picture are to be 
included in the configured TAB sequence. In this example objects with a mouse operation 
event will be included in the TAB sequence: 


Sub ConfigureTabOrder () 
"VBA736 

With ActiveDocument 
.TABOrderAllHMIObjects = True 
.TABOrderKeyboard = False 


.TABOrderMouse = Fals 
-TABOrderOtherAction = False 
End With 

End Sub 

See also 


TabOrderOtherAction Property (Page 2432) 
TabOrderKeyboard Property (Page 2431) 
TabOrderAllHMlObjects Property (Page 2430) 
Document Object (Page 1949) 


TabOrderOtherAction Property 


Description 


TRUE if objects with an event other than a mouse or keyboard operation event configured to 
them are to be included in the configured TAB sequence. BOOLEAN write-read access. 
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3.6 VBA Reference 


The "ConfigureTabOrder()" procedure defines which objects in the active picture are to be 
included in the configured TAB sequence. In this example objects with events other than a 


mouse or keyboard operation will be included in the TAB sequence: 


Sub ConfigureTabOrder () 


'VBA737 


With ActiveDocument 


.TABOrderAllHMIObjects = True 
.TABOrderKeyboard = False 


. TABOrderMous 


= Fals 


-TABOrderOtherAction = False 


End Sub 


See also 


End With 


TabOrderMouse Property (Page 2432) 
TabOrderKeyboard Property (Page 2431) 
TabOrderAllHMlObjects Property (Page 2430) 
Document Object (Page 1949) 


TabOrderSwitch Property 


Description 


Defines or returns the position of the object in the TAB sequence. 
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3.6 VBA Reference 


Example: 


In this example two I/O fields will be inserted in the active picture and the TAB sequence will 


then be defined: 


Sub I0FieldConfig() 

'VBA732 

Dim objIOFieldl As HMIIOField 
Dim objIOField2 As HMIIOField 


Set obj1IOFieldl = ActiveDocument.HMIObjects.AddHMIObject ("IOField1i", "HMIIOField") 
Set objIOField2 = ActiveDocument .HMIObjects.AddHMIObject ("IOField2", "HMIIOField") 


With objIOFieldl 
-Top = 10 

-Left = 10 
-TabOrderSwitch = 1 
End With 

With objIOField2 
-Top = 100 

-Left = 10 
-TabOrderSwitch = 2 
End With 

End Sub 


See also 


HM|Object Object (Page 1988) 


Tag Property 


Description 


Defines or returns information text for a user-defined menu entry or user-defined icon. You 
can use the Tag property for example to briefly describe what the menu entry does. 
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3.6 VBA Reference 


Example: 
In the following example, a user-defined menu with two menus entries and a submenu with 
two entries will be created in the active picture. The submenu will be visually distinguished by 
a dividing line: 
Sub CreateDocumentMenus () 
"VBA738 


Dim objDocMenu As HMIMenu 
Dim objMenuItem As HMIMenuItem 


Dim objSubMenu As HMIMenuItem 

' 

"Add menu: 

Set objDocMenu = ActiveDocument.CustomMenus.InsertMenu (1, 


‘Add menuitems to custom-menu: 
Set objMenuItem = 


Set objMenultem = 


"Add seperator to custom-menu: 


Set objMenuItem = 


"Add submenu to custom-menu: 
Set objSubMenu = 


‘Add menuitems to submenu: 
Set objMenultem = objSubMenu.SubMenu.InsertMenuItem(5, 


Set objMenuItem = objSubMenu.SubMenu.InsertMenulItem(6, 


submenuitem") 

' 

"To place an additional information: 
With objDocMenu 


-MenuItems(1).Tag = "This is the first menuitem" 


End With 
End Sub 
See also 
Toolbarltem Object (Page 2083) 
Menultem Object (Page 2013) 
Tag property 
Description 


objDocMenu.Menultems.InsertMenultem(1, 
objDocMenu.Menultems.InsertMenultem(2, 


objDocMenu.Menultems.InsertSeparator (3, 


obj DocMenu.MenulItems.InsertSubMenu (4, 


"DocMenul", "Doc Menu_1") 


"dmIteml 1", 
"dmIteml 2", 


"My first menuitem") 
"My second menuitem") 


"dSeparatorl 3") 
"My first submenu") 


"dSubMenul_4", 


"dmItem1l 5", 
"dmIteml 6", 


"My first submenuitem") 
"My second 


Is used for the "Graphic Object Update Wizard" tool and is not evaluated for the 
"HMlAdvancedAnalogDisplay" and "HMlAdvancedStateAnalogDisplay" objects. 
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3.6 VBA Reference 


tagname property 


Description 


Is used for the "Graphic Object Update Wizard" tool and is not evaluated for the 
"HMlAdvancedAnalogDisplay" and "HMlAdvancedStateAnalogDisplay" objects. 


TagPrefix Property 


Description 


2436 


Defines or returns the tag prefix for all the tags contained in the Picture Window object. 


Example: 


The picture "InputOutput" is to be displayed in the picture window. The picture "InputOutput" 
contains three I/O fields which are linked to a structure tag. The structure tag consists of the 
elements EA1, EA2, EA3; one element each for each I/O field. 


Three such structure tags have been define in the project, with structure names Struct1, Struct2 
and Struct3. 


The tag prefix is in this case the structure name followed by a period. Specify the tag prefix 
as, say, Struct2. (the period is necessary in order to address the elements of the structure tag 
as structure elements in a syntactically correct way). The I/O fields in the picture "InputOutput" 
are then linked to the elements in structure tag Struct2: 


Tag Prefix: "Struct2." 

© Output value (first I/O field): EA1 

e Output value (second I/O field): EA2 

© Output value (third I/O field): EA3 

The current tag connection in the picture window is then 
© Output value (first I/O field): Struct2.EA1 

e Output value (second I/O field): Struct2.EA2 

e Output value (third I/O field): Struct2.EA3 
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Example: 


3.6 VBA Reference 


The "PictureWindowConfig" procedure accesses the properties of the picture window. In this 


example the picture window will be configured: 


Sub PictureWindowConfig() 
'VBA739 
Dim objPicWindow As HMIPictureWindow 


Set objPicWindow = ActiveDocument.HMIObjects.AddHMIObject ("PicWindow1l", "HMIPictureWindow") 


With objPicWindow 

-AdaptPicture = False 

-AdaptSize = False 

-Caption = True 

-CaptionText = "Picturewindow in runtime" 
-OffsetLeft = 5 

-OffsetTop = 10 


"Replace the picturename "Test.PDL" with the name of 


‘an existing document from your "GraCS"-Folder of your active project 


-PictureName = "Test.PDL" 
-ScrollBars = True 
.ServerPrefix = "my Server::" 
-TagPrefix = "Struct." 
-UpdateCycle = 5 

-Zoom = 100 

End With 

End Sub 


See also 
PictureWindow Object (Page 2029) 


TagScaleParam1 property 


Description 

Sets the value1 for the value range process. 
TagScaleParamz2 property 
Description 


Sets the value2 for the value range process. 
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3.6 VBA Reference 


TagScaleParam3 property 


Description 


Sets the value3 for the value range process. 


TagScaleParam4 property 


Description 


Sets the value4 for the value range process. 


TagStartvaluePersistence property 


Description 


tagtype property 


Description 


Defines whether an internal tag is set as persistent. You can only set internal tags as persistent. 


Is used for the "Graphic Object Update Wizard" tool and is not evaluated for the 
"HMIAdvancedAnalogDisplay" and "HMlAdvancedStateAnalogDisplay" objects. 


Template property 


Description 


GSC Diagnostics 


Returns the template for displaying the window content of the "ApplicationWindow" object. 
Read only access. 


The "ApplicationWindow" object can be supplied from applications of the Global Script and the 
report system: 


The application window is supplied by applications of the Global Script. The results of the diag- 
nostics system are displayed. 


GSC Runtime The application window is supplied by applications of the Global Script. The analysis results 
regarding characteristics in Runtime are displayed. 
All Jobs The application window is supplied by the report system. The available reports are displayed as 


a list. 


All Jobs — Shortcut Menu | The application window is supplied by the report system. The available reports are displayed as 


a list. The shortcut menu enables the selection of print options, display of a print preview as well 
as a printout of the report. 
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Job Detail View The application window is supplied by the report system. The available reports are displayed in 
a selection menu. Detailed information is displayed for the selected report. 


Selected Jobs - Shortcut | The application window is supplied by the report system. The available reports are displayed as 
Menu a list. This list only contains reports which you have activated the option "Mark for print job list" 
in the "Print Job Properties" dialog. The shortcut menu enables the selection of print options, 
display of a print preview as well as a printout of the report. 


See also 

ApplicationWindow Object (Page 1911) 
Text Property 
Description 

Defines or returns the labeling for an object. 
Example: 


The "ButtonConfiguration()" procedure accesses the properties of the button. In this example 
the label will be defined: 


Sub ButtonConfiguration() 

'VBA740 

Dim objButton As HMIButton 

Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("Button1l", "“HMIButton") 
With objButton 

-Text = "Buttonl" 

End With 

End Sub 


See also 
Button Object (Page 1921) 
StaticText Object (Page 2067) 
OptionGroup Object (Page 2025) 
CheckBox Object (Page 1924) 


TextBiblIDs property 
Description 


Only used internally. 
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3.6 VBA Reference 


See also 
TextList Object (Page 2076) 


TitleBackColorActiveEnd property 


Description 
Only used internally. 


See also 
PictureWindow Object (Page 2029) 


TitleBackColorActiveStart property 


Description 
Only used internally. 


See also 
PictureWindow Object (Page 2029) 


TitleBackColorlnactiveEnd property 


Description 
Only used internally. 


See also 
PictureWindow Object (Page 2029) 


TitleBackColorinactiveStart property 


Description 

Only used internally. 
See also 

PictureWindow Object (Page 2029) 
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TitleForeColorActive property 


Description 


Only used internally. 


See also 
PictureWindow Object (Page 2029) 


TitleForeColorinactive property 


Description 
Only used internally. 
See also 
PictureWindow Object (Page 2029) 
Toggle Property 
Description 
TRUE, if the button or round button should lock after being operated in Runtime. BOOLEAN 
write-read access. 
Example: 


The "RoundButtonConfiguration()" procedure accesses the properties of the RoundButton. In 
this example the round button is intended to latch down when pressed in Runtime: 


Sub RoundButtonConfiguration () 

"VBA741 

Dim objRoundButton As HMIRoundButton 

Set objRoundButton = ActiveDocument.HMIObjects.AddHMIObject ("RButtonl", "HMTRoundButton") 
With objRoundButton 

-Toggle = True 

End With 

End Sub 


See also 
RoundButton Object (Page 2052) 
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ToleranceHigh Property 


Description 
Defines or returns the limit value for "Tolerance high". 


The type of the evaluation (in percent or absolute) is defined in the TypeToleranceHigh 
property. 


Monitoring of the limit value only takes effect when the CheckToleranceHigh property is set to 
"True". 


Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the limit values. In 
this example the limit value for "Tolerance High" will be configured: 


Sub BarGraphLimitConfiguration () 
"VBA742 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis = absolute 
.TypeToleranceHigh = Fals 

"Activate monitoring 
-CheckToleranceHigh = Tru 

"Set barcolor = "yellow" 
-ColorToleranceHigh = RGB(255, 255, 0) 
"Set upper limit to "40" 
-ToleranceHigh = 40 

End With 

End Sub 


See also 
TypeToleranceHigh Property (Page 2456) 
CheckToleranceHigh Property (Page 2176) 
BarGraph Object (Page 1914) 


ToleranceLow Property 


Description 
Defines or returns the limit value for "Tolerance low". 
The type of the evaluation (in percent or absolute) is defined in the TypeT oleranceLow property. 


Monitoring of the limit value only takes effect when the CheckToleranceLow property is set to 
"True". 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the limit values. In 
this example the limit value for "Tolerance Low" will be configured. 


Sub BarGraphLimitConfiguration () 
"VBA743 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis = absolute 
.TypeToleranceLow = Fals 

"Activate monitoring 
-CheckToleranceLow = Tru 

"Set barcolor = "red" 
-ColorToleranceLow = RGB(255, 0, O) 
"Set lower limit to "40" 
-ToleranceLow = 40 


End With 
End Sub 
See also 
TypeToleranceLow Property (Page 2457) 
CheckToleranceLow Property (Page 2177) 
BarGraph Object (Page 1914) 
Toolbarltems Property 
Description 


Returns a listing containing all the elements (icons and separation lines) of a user-defined 
toolbar. 
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Example 


In the following example a user-defined toolbar with two icons is created in the active picture. 
These icons are separated by a dividing line: 


Sub AddDocumentSpecificCustomToolbar () 
"VBA744 

Dim objToolbar As HMIToolbar 

Dim objToolbarItem As HMIToolbarItem 


Set objToolbar = ActiveDocument.CustomToolbars.Add("DocToolbar") 
' 


"Add symbol-icon to userdefined toolbar 

Set objToolbariItem = objToolbar.ToolbarItems.InsertToolbarItem(1, "tIteml_ 1", "My first 
symbol-icon") 
Set objToolbariItem = objToolbar.ToolbarItems.InsertToolbarItem(3, "tIteml 3", "My second 
symbol-icon") 
Set objToolbariItem = objToolbar.ToolbarItems.InsertSeparator (2, "tSeparatorl 2") 
End Sub 


See also 
Toolbarltem Object (Page 2083) 
Toolbar Object (Page 2080) 


ToolbarltemType property 


Description 
Returns the type of the "HMIToolbarltem" object of a user-defined toolbar as a "string". 
Returned Value Type in the toolbar 
0 Separator 
1 Icon 
Example 


In the following example the type of the first object in the first user-defined toolbar in the active 
picture is output: 


Sub ShowFirstObjectOfCollection() 


"VBA353 

Dim strType As String 

strType = ActiveDocument.CustomToolbars (1) .ToolbarItems(1).ToolbarItemType 
sgBox strType 

End Sub 
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ToolTipText Property 


Description 


Defines or returns the text that will be displayed as a Tooltip when you run the mouse over an 
object (HMIObject, icon). 


Example: 


The "RectangleConfiguration()" procedure accesses the properties of the Rectangle object. In 
this example a tool tip text will be assigned to the rectangle: 


Sub RectangleConfiguration () 

"VBA745 

Dim objRectangle As HMIRectangle 

Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 
With objRectangle 

-ToolTipText = "This is a rectangle" 

End With 

End Sub 


The following example shows how you have to initialize the property prior to dynamization: 


Sub Dyn () 
"VBA823 
Dim objCircle As HMICircle 

Dim doc As Document 

Dim objDynDialog As HMIDynamicDialog 

Set doc = ActiveDocument 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle", "HMICircle") 
objCircle.ObjectName = "Circlel" 

objCircle.BorderColor = RGB(255, 0, 0) 

objCircle.BackColor = RGB(0O, 255, 0) 

objCircle.ToolTi 


ipText = "Text" 
Set objDynDialog = 
objCircle.ToolTipText.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, "'Var'") 
End Sub 


™m 


See also 
Toolbarltem Object (Page 2083) 
HM|Object Object (Page 1988) 
How to dynamize a property with the Dynamic dialog (Page 1691) 
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Top Property 
Description 
Defines or returns the Y-coordinate of an object (measured from the top left edge of the picture) 
in pixels. The Y-coordinate relates to the top left corner of the rectangle enclosing the object. 
Example: 


The "RectangleConfiguration()" procedure accesses the properties of the Rectangle object. In 
this example the rectangle will be set to position 10/40: 


Sub RectangleConfiguration () 

"VBA746 

Dim objRectangle As HMIRectangle 

Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 
With objRectangle 

-Left = 10 

-Top = 40 

End With 

End Sub 


See also 
View Object (Page 2102) 
HM|Object Object (Page 1988) 


TopConnectedObjectName Property 


Description 
Returns the name of the end object to which the connector is connected. Read only access. 
Example: 
An example showing how to use the BottomConnectedObjectName property can be found in 
this documentation under the heading "ObjConnection Object". 
See also 


ObjConnection object (Page 2019) 
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TopConnectedConnectionPointindex Property 


3.6 VBA Reference 


Returns the connection point on the object to which the connector is connected. 


Assigned Value 
0 


wW}hN]— 


An example showing how to use the BottomConnectedObjectName property can be found in 


this documentation under the heading "ObjConnection Object". 


Description 
Connection Point 
Up 
Right 
Down 
Left 
Example: 
See also 


ObjConnection object (Page 2019) 


Transparency property 


Description 


Defines the degree of transparency of the object display. Values between 0 and 100 indicate 
the transparency as a percentage. In the case of a semi-transparent objects other objects 
shine through. A 100% transparent object is invisible. An invisible object can also be controlled 


in Runtime. 
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3.6 VBA Reference 


Example 


Sub addTransparentObject () 


"VBA849 
Dim objJHMICircle As HMICircle 
Set objJHMICircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle", "HMICircle") 
objJHMICircle.Transparency = 40 
End Sub 
Trend Property 
Description 
TRUE if the trend or tendency of the measured value being monitored (rising or falling) is to 
be indicated by a little arrow. BOOLEAN write-read access. 
Example: 


The "BarGraphConfiguration()" procedure configures In this example the trend of the 
measured value will be indicated: 


Sub BarGraphConfiguration () 

"VBA747 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

.trend = True 

End With 

End Sub 


See also 
BarGraph Object (Page 1914) 


trend property 


Description 


Is used for the "Graphic Object Update Wizard" tool and is not evaluated for the 
"HMlAdvancedAnalogDisplay" and "HMlAdvancedStateAnalogDisplay" objects. 
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TrendColor Property 


Description 


Example: 


Defines or returns the color of the trend display. 


The trend display indicates the tendency (rising or falling) of the measuring value being 
monitored by a small arrow. In order to activate the trend display, the Trend property must be 
set to "True". LONG write-read access. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


The "BarGraphConfiguration()" procedure configures In this example the trend in the measured 
value will be indicated. The trend display will be set to "Red": 


Sub BarGraphConfiguration() 


"VBA748 


Dim objBarGraph As HMIBarGraph 
Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 


-trend = True 


-TrendColor = RGB(255, 0, O) 


End With 
End Sub 


See also 


Trigger Property 


Description 


Trend Property (Page 2448) 
BarGraph Object (Page 1914) 


Returns a Trigger object. Use the Trigger property when making a property dynamic with the 
aid of a script. 
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Example: 


In this example the "Radius" property of a circle will be made dynamic with the aid of a C script 
(the output value sets the radius): 


Sub AddDynamicAsCSkriptToProperty () 
"VBA749 

Dim objVBScript As HMIScriptInfo 
Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("myCircle", "HMICircle") 
Set objVBScript = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeVBScript) 
With objVBScript 


-Trigger.Type = hmiTriggerTypeStandardCycle 
.Trigger.CycleType = hmiCycleType 2s 
.Trigger.Name = "Triggerl" 

End With 

End Sub 

See also 


Trigger Object (Page 2087) 
ScriptInfo Object (Page 2058) 


Type Property 
Description 

Returns or defines the type of an object. 

The object type is returned as either a string or and integer. 
Example: 


The "RectangleConfiguration()" procedure accesses the properties of the Rectangle object. In 
this example the object type will be output: 


Sub RectangleConfiguration () 

'VBA750 

Dim objRectangle As HMIRectangle 

Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("Rectanglel", "HMIRectangle") 
With objRectangle 

sgBox "Objecttype: " & .Type 

End With 

End Sub 
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See also 
Trigger Object (Page 2087) 
Toolbarltem Object (Page 2083) 
SourceLink Object (Page 2065) 
Property Object (Page 2042) 
HM|Object Object (Page 1988) 
Folderltem Object (Page 1972) 
DestLink Object (Page 1945) 


TypeAlarmHigh Property 


Description 


3.6 VBA Reference 


TRUE, when the upper limit value, at which an alarm is triggered, should be evaluated as a 
percentage. FALSE, when the evaluation should be as an absolute value. BOOLEAN write- 


read access. 


Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the high limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 


triggered at a value of "50". 


Sub BarGraphLimitConfiguration () 
"VBA751 


Dim objBarGraph As HMIBarGraph 


Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", 


With objBarGraph 

"Set analysis = absolute 
.TypeAlarmHigh = False 
"Activate monitoring 
.CheckAlarmHigh = True 
"Set barcolor = "yellow" 
-ColorAlarmHigh = RGB(255, 255, 0) 
"Set upper limit = "50" 
-AlarmHigh = 50 

End With 

End Sub 


See also 
ColorAlarmHigh Property (Page 2182) 
CheckAlarmHigh Property (Page 2170) 
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3.6 VBA Reference 


AlarmHigh Property (Page 2114) 
BarGraph Object (Page 1914) 


TypeAlarmLow Property 


Description 


Example: 


TRUE, when the lower limit value, at which an alarm is triggered, should be evaluated as a 
percentage. FALSE, when the evaluation should be as an absolute value. BOOLEAN write- 


read access. 


The "BarGraphLimitConfiguration()" procedure configures the properties of the low limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 


triggered at a value of "10". 


Sub BarGraphLimitConfiguration () 


"VBA752 


Dim objBarGraph As HMIBarGraph 


Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", 


With objBarGraph 


"Set analysis 
. TypeAlarmLow 


= absolute 
= False 


"Activate monitoring 
-CheckAlarmLow = True 


"Set barcolor 


= "yellow" 


-ColorAlarmLow = RGB(255, 255, 0) 
"Set Lower limit = "10" 
-AlarmLow = 10 


End With 
End Sub 


See also 
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ColorAlarmLow Property (Page 2183) 
CheckAlarmLow Property (Page 2171) 
AlarmLow Property (Page 2115) 


BarGraph Object (Page 1914) 


"HMIBarGraph") 
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TypeLimitHigh4 Property 


Description 


TRUE, when the "Reserve 4" upper limit value should be evaluated as a percentage. FALSE, 
when the evaluation should be as an absolute value. BOOLEAN write-read access. 


Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the high limit value 


for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "70". 


Sub BarGraphLimitConfiguration () 
"VBA753 

Dim objBarGraph As HMIBarGraph 
Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "“HMIBarGraph") 
With objBarGraph 

"Set analysis = absolute 
.TypeLimitHigh4 = False 

"Activate monitoring 
-CheckLimitHigh4 = True 

"Set barcolor = "red" 
-ColorLimitHigh4 = RGB(255, 0, 0) 
‘Set upper limit = "70" 
-LimitHigh4 = 70 

End With 

End Sub 


See also 
LimitHigh4 Property (Page 2307) 
CheckLimitHigh4 Property (Page 2172) 
BarGraph Object (Page 1914) 


TypeLimitHigh5 Property 


Description 


TRUE, when the "Reserve 5" upper limit value should be evaluated as a percentage. FALSE, 
when the evaluation should be as an absolute value. BOOLEAN write-read access. 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the high limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "80". 


Sub BarGraphLimitConfiguration () 
"VBA754 
Dim objBarGraph As HMIBarGraph 


Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis = absolute 

.TypeLimitHigh5 = False 

"Activate monitoring 


-CheckLimitHigh5 = True 

"Set barcolor = "black" 
-ColorLimitHigh5 = RGB(0, 0, 0) 
"Set upper limit = "70" 
-LimitHigh5 = 70 

End With 

End Sub 
See also 


LimitHigh5 Property (Page 2307) 
CheckLimitHigh5 Property (Page 2173) 
BarGraph Object (Page 1914) 


TypeLimitLow4 Property 


Description 


TRUE, when the "Reserve 4" lower limit value should be evaluated as a percentage. FALSE, 
when the evaluation should be as an absolute value. BOOLEAN write-read access. 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the low limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "5". 


Sub BarGraphLimitConfiguration () 

"VBA755 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis = absolute 

.TypeLimitLow4 = False 

"Activate monitoring 


-CheckLimitLow4 = True 

"Set barcolor = "green" 
-ColorLimitLow4 = RGB(0, 255, 0) 
"Set lower limit = "5" 
-LimitLow4 = 5 

End With 

End Sub 
See also 


LimitLow4 Property (Page 2308) 
ColorLimitLow4 Property (Page 2187) 
CheckLimitLow4 Property (Page 2174) 
BarGraph Object (Page 1914) 


TypeLimitLow5 Property 


Description 


TRUE, when the "Reserve 5" lower limit value should be evaluated as a percentage. FALSE, 
when the evaluation should be as an absolute value. BOOLEAN write-read access. 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the low limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "0". 


Sub BarGraphLimitConfiguration () 

"VBA756 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis = absolute 

.TypeLimitLow5 = False 

"Activate monitoring 


-CheckLimitLow5 = True 
"Set barcolor = "white" 
-ColorLimitLow5 = RGB(255, 255, 255) 
"Set lower limit = "0" 
-LimitLow5 = 0 
End With 
End Sub 
See also 


LimitLow5 Property (Page 2309) 
ColorLimitLow5 Property (Page 2188) 
CheckLimitLow5 Property (Page 2175) 
BarGraph Object (Page 1914) 


TypeToleranceHigh Property 


Description 
TRUE, when the "Tolerance high" lower limit value should be evaluated as a percentage. 
FALSE, when the evaluation should be as an absolute value. BOOLEAN write-read access. 
WinCC: Scripting (VBS, ANSI-C, VBA) 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the limit values. In 
this example the limit value for "Tolerance High" will be configured: 


Sub BarGraphLimitConfiguration () 

"VBA757 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis = absolute 

.TypeToleranceHigh = Fals 

"Activate monitoring 


-CheckToleranceHigh = Tru 
"Set barcolor = "yellow" 
-ColorToleranceHigh = RGB(255, 255, 0) 
‘Set upper limit = "40" 
.-ToleranceHigh = 40 
End With 
End Sub 
See also 


ColorToleranceHigh Property (Page 2189) 
CheckToleranceHigh Property (Page 2176) 
BarGraph Object (Page 1914) 


TypeToleranceLow Property 


Description 


TRUE, when the "Tolerance low" lower limit value should be evaluated as a percentage. 
FALSE, when the evaluation should be as an absolute value. BOOLEAN write-read access. 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the limit values. In 
this example the limit value for "Tolerance Low" will be configured: 


Sub BarGraphLimitConfiguration () 

'VBA758 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument .HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis = absolute 

.TypeToleranceLow = Fals 

"Activate monitoring 


-CheckToleranceLow = Tru 
"Set barcolor = "red" 
-ColorToleranceLow = RGB(255, 0, 0) 
"Set lower limit = "10" 
-ToleranceLow = 10 
End With 
End Sub 
See also 


ToleranceLow Property (Page 2442) 
ColorToleranceLow Property (Page 2190) 
CheckToleranceLow Property (Page 2177) 
BarGraph Object (Page 1914) 


TypeWarningHigh Property 


Description 


TRUE, when the "Warning high" lower limit value should be evaluated as a percentage. FALSE, 
when the evaluation should be as an absolute value. BOOLEAN write-read access. 
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Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the high limit value 


for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "75". 


Sub BarGraphLimitConfiguration () 
"VBA759 

Dim objBarGraph As HMIBarGraph 
Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis = absolute 
.TypeWarningHigh = False 

"Activate monitoring 
.CheckWarningHigh = True 

"Set barcolor = "red" 
-ColorWarningHigh = RGB(255, 0, 0) 
"Set upper limit = "75" 
-WarningHigh = 75 

End With 

End Sub 


See also 
WarningHigh Property (Page 2552) 
ColorWarningHigh Property (Page 2192) 
CheckWarningHigh Property (Page 2178) 
BarGraph Object (Page 1914) 


TypeWarningLow Property 


Description 


TRUE, when the "Warning low" lower limit value should be evaluated as a percentage. FALSE, 
when the evaluation should be as an absolute value. BOOLEAN write-read access. 
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3.6 VBA Reference 


Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the low limit value 


for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "12". 


Sub BarGraphLimitConfiguration () 

"VBA760 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

"Set analysis = absolute 

.TypeWarningLow = False 

"Activate monitoring 


-CheckWarningLow = True 

"Set barcolor = "magenta" 
-ColorWarningLow = RGB(255, 0, 255) 
"Set lower limit = "12" 

-WarningLow = 12 

End With 

End Sub 
See also 


WarningLow Property (Page 2553) 
ColorWarningLow Property (Page 2193) 
CheckWarningLow Property (Page 2179) 
BarGraph Object (Page 1914) 


Underlined Property 


Description 


TRUE if the font attribute "Underline" is set for the language-dependent text in the object. 
BOOLEAN write-read access. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
2460 System Manual, 02/2016, ASE37536061-AA 


VBA for Automated Configuration 


Example: 


3.6 VBA Reference 


The following example sets the font attributes of a button for French and English: 


Sub ExampleForLanguageFonts () 
"VBA761 

Dim colLangFonts As HMILanguageFonts 
Dim objButton As HMIButton 


Set objButton = ActiveDocument.HMIObjects.AddHMIObject ("myButton", "HMTButton") 


objButton.Text = "DefText" 

Set colLangFonts = objButton.LDFonts 
' 

"Set font-properties for french: 
With colLangFonts.ItemByLCID (1036) 
-Family = "Courier New" 

-Bold = True 

-Italic = False 

-Underlined = Tru 

-Size = 12 

End With 


"Set font-properties for english: 
With colLangFonts.ItemByLCID (1033) 
-Family = "Times New Roman" 

-Bold = False 

-Italic = True 

-Underlined = Fals 

-Size = 14 

End With 

End Sub 


See also 
Size Property (Page 2419) 
Parent Property (Page 2359) 
LanguagelD Property (Page 2289) 
Italic Property (Page 2282) 
Family Property (Page 2229) 
Bold Property (Page 2151) 
Application Property (Page 2121) 
LanguageFont Object (Page 1996) 
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UnselBGColor Property 


Description 


Defines or returns the background color of entries in the text list object which are not selected. 
LONG write-read access. 


Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 


Example: 


The "TextListConfiguration()" procedure accesses the properties of the object TextList. In this 
example the colors will be defined for entries that are not selected in the selection list: 


Sub TextListConfiguration () 

"VBA762 

Dim objTextList As HMITextList 

Set objTextList = ActiveDocument.HMIObjects.AddHMIObject ("myTextList", "HMITextList") 
With objTextList 

»-UnselBGColor = RGB(255, 0, 0) 

-UnselTextColor = RGB(0O, O, O) 


End With 
End Sub 
See also 
TextList Object (Page 2076) 
UnselTextColor Property 
Description 


In the case of the TextList object, defines or returns the color of text in the selection list for 
entries that are not selected. LONG write-read access. 
Determination of Color Value 


The color is displayed in RGB format (Red, Green, Blue). Specify the corresponding decimal 
value for each of the three RGB values (value range from 0 to 255). 


Use VBA function "RGB" to assign a color to a property. The color "red", for example, is 
represented as follows: RGB(255, 0, 0) 
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3.6 VBA Reference 


Example: 


The "TextListConfiguration()" procedure accesses the properties of the object TextList. In this 
example the colors will be defined for entries that are not selected in the selection list: 


Sub TextListConfiguration () 

"VBA763 

Dim objTextList As HMITextList 

Set objTextList = ActiveDocument.HMIObjects.AddHMIObject ("myTextList", "HMITextList") 
With objTextList 

.UnselBGColor = RGB(255, 0, 0) 

-UnselTextColor = RGB(0O, O, O) 


End With 
End Sub 
See also 
TextList Object (Page 2076) 
UpdateCycle Property 
Description 


Defines or returns the type and frequency of updates to the picture window in Runtime. 


Update Cycle Assigned Value 
Upon change 0 
250 ms 1 
500 ms 2 
1s 3 
2s 4 
5s 5 
10s 6 

1 min 7 

5 min 8 
10 min 9 
1h 10 
User cycle 1 11 
User cycle 2 12 
User cycle 3 13 
User cycle 4 14 
User cycle 5 15 
Picture cycle 255 
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Example: 


The "PictureWindowConfig" procedure accesses the properties of the picture window. In this 
example the picture window will be updated every 5 seconds in Runtime: 


Sub PictureWindowConfig() 

"VBA764 

Dim objPicWindow As HMIPictureWindow 

Set objPicWindow = ActiveDocument.HMIObjects.AddHMIObject ("PicWindowl", "HMIPictureWindow") 
With objPicWindow 

-UpdateCycle = 5 


End With 
End Sub 
See also 
PictureWindow Object (Page 2029) 
UseEventState property 
Description 
Specifies for the "HMlAdvancedStateDisplay" object whether the group value is evaluated for 
the representation of the states. 
If the group value is used, you can assign pictures for the individual alarm statuses. 
UsedLanguage property 
Description 


Use the UsedLanguage property to set the code page that matches the character set used. 


LONG write-read access. 
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Example 


The "UsedLanguage" property and language ID "1033" are used in the following example to 
set the code page to English US. 


Sub AddDynamicAsCSkriptToProperty () 
"VBA856 
Dim objCScript As HMIScriptInfo 
Dim objCircle As HMICircle 
Dim strCode As String 
strCode = "long lHeight;" & vbCrLf & "int check;" & vbCrLf 
strCode = strCode & "GetHeight (""events.PDL"", ""myCircle"™"); & vbcrlf" 
strCode = strCode & "lHeight = lHeight+5;" & vbCrLf 
strCode = strCode & "check = SetHeight (""events.PDL"", ""myCircle"", lHeight) ;" 
strCode = strCode & vbCrLf & "//Return-Type: BOOL" & vbCrLf 
strCode = strCode & "return check;" 
Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle C", "HMICircle") 
"Create dynamic for Property "Radius": 
Set objCScript = objCircle.Height.CreateDynamic (hmiDynamicCreationTypeCScript) 
"set Sourcecode and cycletime: 
With objCScript 
-SourceCode = strCode 


a 


.Trigger.Type = hmiTriggerTypeStandardCycle 


= 


.Trigger.CycleType = hmiCycleType 2s 
.Trigger.Name = "Triggerl" 
"Set language English-US 
.UsedLanguage = 1033 

End With 

End Sub 


UseGlobalAlarmClasses property 


Description 
Defines whether to use globally configured alarm classes to visualize message events. The 
property is only relevant for PCS7 projects. 
Value Description 
TRUE Activates the global settings made in PCS7 alarm editor for 
visualizing the message events. 
FALSE Visualization of the message events is defined locally for each 
message class. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 2465 


VBA for Automated Configuration 
3.6 VBA Reference 


UseGlobalSettings property 


Description 


Specify whether to use global settings to assign message events to the buttons visualized in 
the group view. The display of the message events is configured using the "MessageClass" 
properties. The property is only relevant for PCS7 projects. 


Value Description 


TRUE Activates the settings made in the PCS7 alarm editor for the 
assignment of message events to the buttons in the group 
display. The bit numbers in the group value are assigned to 
the respective buttons. 


FALSE The message types are assigned locally to the buttons in the 
group display. 


UserValue1 Property 


Description 
Defines or returns any value in the case of the GroupDisplay object. 
The value can be evaluated by a script, for example. This value is neither evaluated nor 
displayed in Runtime. 

Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example four different user values will be assigned: 


Sub GroupDisplayConfiguration() 
"VBA765 

Dim objGroupDisplay As HMIGroupDisplay 
Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMTGroupDisplay") 

With objGroupDisplay 

.UserValuel = 0 

-UserValue2 = 25 

.UserValue3 = 50 

-UserValue4 = 75 

End With 

End Sub 


See also 
UserValue4 Property (Page 2468) 
UserValue3 Property (Page 2467) 
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UserValue2-Eigenschaft (Page 2467) 
GroupDisplay Object (Page 1980) 


UserValue2-Eigenschaft 


Description 
Defines or returns any value in the case of the GroupDisplay object. 
The value can be evaluated by a script, for example. This value is neither evaluated nor 
displayed in Runtime. 

Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example four different user values will be assigned: 


Sub GroupDisplayConfiguration() 
"VBA766 

Dim objGroupDisplay As HMIGroupDisplay 
Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 
"HMTGroupDisplay") 

With objGroupDisplay 

.UserValuel = 0 

.UserValue2 25 

.UserValue3 = 50 

-UserValue4 = 75 

End With 

End Sub 


See also 
UserValue4 Property (Page 2468) 
UserValue3 Property (Page 2467) 
UserValue1 Property (Page 2466) 
GroupDisplay Object (Page 1980) 


UserValue3 Property 


Description 
Defines or returns any value in the case of the GroupDisplay object. 


The value can be evaluated by a script, for example. This value is neither evaluated nor 
displayed in Runtime. 
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Example: 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 
In this example four different user values will be assigned: 


Sub GroupDisplayConfiguration() 
'VBA767 
Dim objGroupDisplay As HMIGroupDisplay 


Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 


"HMTGroupDisplay") 
With objGroupDisplay 
.UserValuel = 0 
-UserValue2 = 25 


Defines or returns any value in the case of the GroupDisplay object. 


The value can be evaluated by a script, for example. This value is neither evaluated nor 


.UserValue3 = 50 
-UserValue4 = 75 
End With 
End Sub 
See also 
UserValue4 Property (Page 2468) 
UserValue2-Eigenschaft (Page 2467) 
UserValue1 Property (Page 2466) 
GroupDisplay Object (Page 1980) 
UserValue4 Property 
Description 
displayed in Runtime. 
2468 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


VBA for Automated Configuration 


Example: 


3.6 VBA Reference 


The "GroupDisplayConfiguration()" procedure accesses the properties of the Group Display. 


In this example four different user values will be assigned: 


Sub GroupDisplayConfiguration() 
'VBA768 
Dim objGroupDisplay As HMIGroupDisplay 


Set objGroupDisplay = ActiveDocument.HMIObjects.AddHMIObject ("GroupDisplayl", 


"HMTGroupDisplay") 
With objGroupDisplay 
.UserValuel = 0 
-UserValue2 = 25 


Specifies whether a text tag is used instead of a formatted analog value. 


.UserValue3 = 50 
-UserValue4 = 75 
End With 
End Sub 
See also 
UserValue3 Property (Page 2467) 
UserValue2-Eigenschaft (Page 2467) 
UserValue1 Property (Page 2466) 
GroupDisplay Object (Page 1980) 
UseValueText property 
Description 
V 
Value 


Value Property 


Description 


Returns or defines the value of an object property. 
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Example: 


Use the Value property if you wish to return or define a value with the aid of the Properties 


listing. In this example the property of an 
property: 


Sub AddActiveXControl () 
"VBA769 
Dim objActiveXControl As HMIActiveXControl 


ActiveX Control will be accessed via the Value 


Set objActiveXControl = ActiveDocument .HMIObjects.AddActiveXControl ("WinCC_Gauge2", 


"XGAUGE. XGaugeCtrl.1") 


"Move ActiveX-Control: 
objActivexXControl.Top = 40 
objActiveXControl.Left = 60 
' 
"Modify individual properties: 
objActiveXControl.Properties ("BackColor") .value = 
End Sub 


See also 
Property Object (Page 2042) 


VALUE_ACCESS_FAULT Property 


Description 


RGB(255, QO, OQ) 


Defines or returns the value that will be assigned to the dynamic property if tag status "Access 


to tag not permitted" occurs. 


The value of the VariableStateChecked property must be TRUE in order for the status to be 


evaluated. 


2470 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle is given dynamics with the The dynamization 
takes place be evaluating the status of a tag. If the tag does not return a status, a substitute 
value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of variablestate 
-VariableStateChecked = Tru 

End With 

With objDynDialog.VariableStateValues (1) 


‘define a value for every state: 
.VALUE_ACCESS FAULT = 20 

. VALUE_ADDRESS ERROR = 30 

. VALUE CONVERSION ERROR = 40 


. VALUE_HANDSHAKE ERROR = 60 


. VALUE_ HARDWARE ERROR = 70 
. VALUE_INVALID KEY = 80 


.VALUE_MAX LIMIT = 90 
.VALUE_MAX RANGE = 100 
.VALUE_MIN_ LIMIT = 110 
.VALUE_MIN_ RANGE = 120 


.- VALUE_NOT_ ESTABLISHED = 130 
. VALUE SERVERDOWN = 140 


.VALUE_ STARTUP VALUE = 150 
.VALUE_TIMEOUT = 160 

End With 

End Sub 

See also 


VALUE_MAX_LIMIT Property (Page 2506) 
VariableStateChecked Property (Page 2545) 
VALUE_TIMEOUT Property (Page 2520) 
VALUE_STARTUP_VALUE Property (Page 2518) 
VALUE_SERVERDOWN Property (Page 2516) 
VALUE_NOT_ESTABLISHED Property (Page 2514) 
VALUE_MIN_RANGE Property (Page 2512) 
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VALUE_MIN_LIMIT Property (Page 2510) 
VALUE_MAX_RANGE Property (Page 2508) 
VALUE_INVALID_KEY Property (Page 2502) 
VALUE_HARDWARE_ERROR Property (Page 2498) 
VALUE_HANDSHAKE_ERROR Property (Page 2496) 
VALUE_CONVERSION_ERROR Property (Page 2494) 
VALUE_ADDRESS_ERROR Property (Page 2472) 
VariableStateValue Object (Page 2096) 


VALUE_ADDRESS_ERROR Property 


Description 


2472 


Defines or returns the value that will be assigned to the dynamic property if tag status 
"Addressing error" occurs. 


The value of the VariableStateChecked property must be TRUE in order for the status to be 
evaluated. 
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Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. The dynamization takes place be evaluating the status of a tag. If the tag does not 
return a status, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA771 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of variablestate 
-VariableStateChecked = Tru 

End With 

With objDynDialog.VariableStateValues (1) 


‘define a value for every state: 
.VALUE_ACCESS FAULT = 20 

. VALUE_ADDRESS ERROR = 30 

. VALUE CONVERSION ERROR = 40 


. VALUE_HANDSHAKE ERROR = 60 


. VALUE_ HARDWARE ERROR = 70 
. VALUE_INVALID KEY = 80 


.VALUE_MAX LIMIT = 90 
.VALUE_MAX RANGE = 100 
.VALUE_MIN_ LIMIT = 110 
.VALUE_MIN_ RANGE = 120 


. VALUE OT ESTABLISHED = 130 
.VALUE_SERVERDOWN = 140 

. VALUE STARTUP VALUE = 150 
.VALUE_TIMEOUT = 160 
End With 

End Sub 


See also 
VariableStateChecked Property (Page 2545) 
VALUE_TIMEOUT Property (Page 2520) 
VALUE_STARTUP_VALUE Property (Page 2518) 
VALUE_SERVERDOWN Property (Page 2516) 
VALUE_NOT_ESTABLISHED Property (Page 2514) 
VALUE_MIN_RANGE Property (Page 2512) 
VALUE_MIN_LIMIT Property (Page 2510) 
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VALUE_MAX_RANGE Property (Page 2508) 
VALUE_MAX_LIMIT Property (Page 2506) 
VALUE_INVALID_KEY Property (Page 2502) 
VALUE_HARDWARE_ERROR Property (Page 2498) 
VALUE_HANDSHAKE_ERROR Property (Page 2496) 
VALUE_CONVERSION_ERROR Property (Page 2494) 
VALUE_ACCESS_FAULT Property (Page 2470) 
VariableStateValue Object (Page 2096) 


VALUE_BAD_COMMLUV Property 


Description 


2474 


Specifies the value assigned to a dynamized property if quality code "bad, no communication 


(last usable value)" occurs, or returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 


TRUE. 
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Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA818 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


VALUE_BAD_DEVICE Property (Page 2480) 
QualityCodeStateChecked Properties (Page 2390) 
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VBA for Automated Configuration 


3.6 VBA Reference 


VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMNUV Property (Page 2476) 
QualityCodeStateValue Object (Page 2044) 


VALUE_BAD_COMMNUV Property 


Description 
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Specifies the value assigned to a dynamized property if quality code "bad, no communication 
(last usable value)" occurs, or returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 
TRUE. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


QualityCodeStateChecked Properties (Page 2390) 
VALUE_UNCERT_SUBSTSET Property (Page 2542) 
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VBA for Automated Configuration 


3.6 VBA Reference 


VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VALUE_BAD_CONFERROR Property 


Description 
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Specifies the value assigned to a dynamized property if quality code "bad, no communication, 
value not accepted" occurs, or returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 
TRUE. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD MISCSTATES = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = 110 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

.- VALUE LOWLIMITED = 140 

. VALUE _UNCERT ENGVHIGHLIM = 150 
. VALUE _UNCERT_ ENGVLOWLIM = 160 
- VALUE UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE UNCERT MAINTDEM = 190 
.VALUE_UNCERT_MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 
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VBA for Automated Configuration 


3.6 VBA Reference 


See also 


VALUE_UNCERT_MISCSTATES Property (Page 2534) 
QualityCodeStateChecked Properties (Page 2390) 
VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VALUE_BAD_DEVICE Property 


Description 
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Specifies a value assigned to a dynamized property if quality code "bad, device failure" occurs, 
or returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 
TRUE. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
QualityCodeStateChecked Properties (Page 2390) 
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VBA for Automated Configuration 


3.6 VBA Reference 


VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VALUE_BAD_MISCSTATES Property 


Description 
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Specifies the value assigned to a dynamized property if quality code "bad miscellaneous 
states" occurs, or returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 
TRUE. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
QualityCodeStateChecked Properties (Page 2390) 
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VBA for Automated Configuration 


3.6 VBA Reference 


VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VALUE_BAD_NONSPECIFIC Property 


Description 
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Specifies the value assigned to a dynamized property if quality code "bad, non-specific" occurs, 
or returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 
TRUE. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
QualityCodeStateChecked Properties (Page 2390) 
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VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VALUE_BAD_NOTCONNECTED Property 


Description 
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Specifies a value assigned to a dynamized property if quality code "bad, not connected" occurs, 
or returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 
TRUE. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


VALUE_HIGHLIMITED Property (Page 2500) 
QualityCodeStateChecked Properties (Page 2390) 
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VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VALUE_BAD_OUTOFSERV Property 


Description 
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Specifies a value assigned to a dynamized property if quality code "bad, out of service" occurs, 
or returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 
TRUE. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


VALUE_BAD_CONFERROR Property (Page 2478) 
QualityCodeStateChecked Properties (Page 2390) 
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VBA for Automated Configuration 
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VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VALUE_BAD_PROCRELNOM Property 


Description 


2490 


Specifies the value assigned to a dynamized property if quality code "bad, process related, no 
maintenance" occurs, or returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 
TRUE. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


VALUE_UNCERT_LUV Property (Page 2530) 
QualityCodeStateChecked Properties (Page 2390) 
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VBA for Automated Configuration 


3.6 VBA Reference 


VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VALUE_BAD_PROCRELSUB Property 


Description 


2492 


Specifies the value assigned to a dynamized property if quality code "bad, process related, 
substitute value" occurs, or returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 
TRUE. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
QualityCodeStateChecked Properties (Page 2390) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 2493 


VBA for Automated Configuration 
3.6 VBA Reference 


VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VALUE_CONVERSION_ERROR Property 


Description 


Defines or returns the value that will be assigned to the dynamic property if tag status 
"Conversion error" occurs. 


The value of the VariableStateChecked property must be TRUE in order for the status to be 
evaluated. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. The dynamization takes place be evaluating the status of a tag. If the tag does not 
return a status, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA772 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of variablestate 
-VariableStateChecked = Tru 

End With 

With objDynDialog.VariableStateValues (1) 


‘define a value for every state: 
.VALUE_ACCESS FAULT = 20 

. VALUE_ADDRESS ERROR = 30 

. VALUE CONVERSION ERROR = 40 


. VALUE_HANDSHAKE ERROR = 60 


. VALUE_ HARDWARE ERROR = 70 
. VALUE_INVALID KEY = 80 


.VALUE_MAX LIMIT = 90 
.VALUE_MAX RANGE = 100 
.VALUE_MIN_ LIMIT = 110 
.VALUE_MIN_ RANGE = 120 


. VALUE OT ESTABLISHED = 130 
.VALUE_SERVERDOWN = 140 

. VALUE STARTUP VALUE = 150 
.VALUE_TIMEOUT = 160 
End With 

End Sub 


See also 
VariableStateChecked Property (Page 2545) 
VALUE_TIMEOUT Property (Page 2520) 
VALUE_STARTUP_VALUE Property (Page 2518) 
VALUE_SERVERDOWN Property (Page 2516) 
VALUE_NOT_ESTABLISHED Property (Page 2514) 
VALUE_MIN_RANGE Property (Page 2512) 
VALUE_MIN_LIMIT Property (Page 2510) 
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VBA for Automated Configuration 


3.6 VBA Reference 


VALUE_MAX_RANGE Property (Page 2508) 
VALUE_MAX_LIMIT Property (Page 2506) 
VALUE_INVALID_KEY Property (Page 2502) 
VALUE_HARDWARE_ERROR Property (Page 2498) 
VALUE_HANDSHAKE_ERROR Property (Page 2496) 
VALUE_ADDRESS_ERROR Property (Page 2472) 
VALUE_ACCESS_FAULT Property (Page 2470) 
VariableStateValue Object (Page 2096) 


VALUE_HANDSHAKE_ERROR Property 


Description 


2496 


Defines or returns the value that will be assigned to the dynamic property if tag status 
"Handshake error" occurs. 


The value of the VariableStateChecked property must be TRUE in order for the status to be 
evaluated. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. The dynamization takes place be evaluating the status of a tag. If the tag does not 
return a status, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA773 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of variablestate 
-VariableStateChecked = Tru 

End With 

With objDynDialog.VariableStateValues (1) 


‘define a value for every state: 
.VALUE_ACCESS FAULT = 20 

. VALUE_ADDRESS ERROR = 30 

. VALUE CONVERSION ERROR = 40 


. VALUE_HANDSHAKE ERROR = 60 


. VALUE_ HARDWARE ERROR = 70 
. VALUE_INVALID KEY = 80 


.VALUE_MAX LIMIT = 90 
.VALUE_MAX RANGE = 100 
.VALUE_MIN_ LIMIT = 110 
.VALUE_MIN_ RANGE = 120 


. VALUE OT ESTABLISHED = 130 
.VALUE_SERVERDOWN = 140 

. VALUE STARTUP VALUE = 150 
.VALUE_TIMEOUT = 160 
End With 

End Sub 


See also 
VariableStateChecked Property (Page 2545) 
VALUE_TIMEOUT Property (Page 2520) 
VALUE_STARTUP_VALUE Property (Page 2518) 
VALUE_SERVERDOWN Property (Page 2516) 
VALUE_NOT_ESTABLISHED Property (Page 2514) 
VALUE_MIN_RANGE Property (Page 2512) 
VALUE_MIN_LIMIT Property (Page 2510) 
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VBA for Automated Configuration 


3.6 VBA Reference 


VALUE_MAX_RANGE Property (Page 2508) 
VALUE_MAX_LIMIT Property (Page 2506) 
VALUE_INVALID_KEY Property (Page 2502) 
VALUE_HARDWARE_ERROR Property (Page 2498) 
VALUE_CONVERSION_ERROR Property (Page 2494) 
VALUE_ADDRESS_ERROR Property (Page 2472) 
VALUE_ACCESS_FAULT Property (Page 2470) 
VariableStateValue Object (Page 2096) 


VALUE_HARDWARE_ERROR Property 


Description 


2498 


Defines or returns the value that will be assigned to the dynamic property if tag status "No 


network module" occurs. 


The value of the VariableStateChecked property must be TRUE in order for the status to be 


evaluated. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. The dynamization takes place be evaluating the status of a tag. If the tag does not 
return a status, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA774 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of variablestate 
-VariableStateChecked = Tru 

End With 

With objDynDialog.VariableStateValues (1) 


‘define a value for every state: 
.VALUE_ACCESS FAULT = 20 

. VALUE_ADDRESS ERROR = 30 

. VALUE CONVERSION ERROR = 40 


. VALUE_HANDSHAKE ERROR = 60 


. VALUE_ HARDWARE ERROR = 70 
. VALUE_INVALID KEY = 80 


.VALUE_MAX LIMIT = 90 
.VALUE_MAX RANGE = 100 
.VALUE_MIN_ LIMIT = 110 
.VALUE_MIN_ RANGE = 120 


.- VALUE_NOT_ ESTABLISHED = 130 
. VALUE SERVERDOWN = 140 


.VALUE_ STARTUP VALUE = 150 
.VALUE_TIMEOUT = 160 

End With 

End Sub 

See also 


VALUE_MAX_RANGE Property (Page 2508) 
VariableStateChecked Property (Page 2545) 
VALUE_TIMEOUT Property (Page 2520) 
VALUE_STARTUP_VALUE Property (Page 2518) 
VALUE_SERVERDOWN Property (Page 2516) 
VALUE_NOT_ESTABLISHED Property (Page 2514) 
VALUE_MIN_RANGE Property (Page 2512) 
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VBA for Automated Configuration 


3.6 VBA Reference 


VALUE_MIN_LIMIT Property (Page 2510) 
VALUE_MAX_LIMIT Property (Page 2506) 
VALUE_INVALID_KEY Property (Page 2502) 
VALUE_HANDSHAKE_ERROR Property (Page 2496) 
VALUE_CONVERSION_ERROR Property (Page 2494) 
VALUE_ADDRESS_ERROR Property (Page 2472) 
VALUE_ACCESS_FAULT Property (Page 2470) 
VariableStateValue Object (Page 2096) 


VALUE_HIGHLIMITED Property 


Description 


2500 


Specifies the value assigned to a dynamized property if quality code "high limited" occurs, or 


returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 


TRUE. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


QualityCodeStateChecked Properties (Page 2390) 
VALUE_UNCERT_SUBSTSET Property (Page 2542) 
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VBA for Automated Configuration 


3.6 VBA Reference 


VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VALUE_INVALID_KEY Property 


Description 


2502 


Defines or returns the value that will be assigned to the dynamic property if tag status "Tag 
not found" occurs. 


The value of the VariableStateChecked property must be TRUE in order for the status to be 
evaluated. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. The dynamization takes place be evaluating the status of a tag. If the tag does not 
return a status, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA775 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of variablestate 
-VariableStateChecked = Tru 

End With 

With objDynDialog.VariableStateValues (1) 


‘define a value for every state: 
.VALUE_ACCESS FAULT = 20 

. VALUE_ADDRESS ERROR = 30 

. VALUE CONVERSION ERROR = 40 


. VALUE_HANDSHAKE ERROR = 60 


. VALUE_ HARDWARE ERROR = 70 
. VALUE_INVALID KEY = 80 


.VALUE_MAX LIMIT = 90 
.VALUE_MAX RANGE = 100 
.VALUE_MIN_ LIMIT = 110 
.VALUE_MIN_ RANGE = 120 


. VALUE OT ESTABLISHED = 130 
.VALUE_SERVERDOWN = 140 

. VALUE STARTUP VALUE = 150 
.VALUE_TIMEOUT = 160 
End With 

End Sub 


See also 
VariableStateChecked Property (Page 2545) 
VALUE_TIMEOUT Property (Page 2520) 
VALUE_STARTUP_VALUE Property (Page 2518) 
VALUE_SERVERDOWN Property (Page 2516) 
VALUE_NOT_ESTABLISHED Property (Page 2514) 
VALUE_MIN_RANGE Property (Page 2512) 
VALUE_MIN_LIMIT Property (Page 2510) 
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VBA for Automated Configuration 
3.6 VBA Reference 


VALUE_MAX_RANGE Property (Page 2508) 
VALUE_MAX_LIMIT Property (Page 2506) 
VALUE_HARDWARE_ERROR Property (Page 2498) 
VALUE_HANDSHAKE_ERROR Property (Page 2496) 
VALUE_CONVERSION_ERROR Property (Page 2494) 
VALUE_ADDRESS_ERROR Property (Page 2472) 
VALUE_ACCESS_FAULT Property (Page 2470) 
VariableStateValue Object (Page 2096) 


VALUE_LOWLIMITED Property 


Description 


Specifies the value assigned to a dynamized property if quality code "low limited" occurs, or 
returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 
TRUE. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


VALUE_BAD_PROCRELSUB Property (Page 2492) 
QualityCodeStateChecked Properties (Page 2390) 
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VBA for Automated Configuration 


3.6 VBA Reference 


VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VALUE_MAX_LIMIT Property 


Description 


2506 


Defines or returns the value that will be assigned to the dynamic property if tag status "Upper 
limit exceeded" occurs. 


The value of the VariableStateChecked property must be TRUE in order for the status to be 
evaluated. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. The dynamization takes place be evaluating the status of a tag. If the tag does not 
return a status, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA776 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of variablestate 
-VariableStateChecked = Tru 

End With 

With objDynDialog.VariableStateValues (1) 


‘define a value for every state: 
.VALUE_ACCESS FAULT = 20 

. VALUE_ADDRESS ERROR = 30 

. VALUE CONVERSION ERROR = 40 


. VALUE_HANDSHAKE ERROR = 60 


. VALUE_ HARDWARE ERROR = 70 
. VALUE_INVALID KEY = 80 


.VALUE_MAX LIMIT = 90 
.VALUE_MAX RANGE = 100 
.VALUE_MIN_ LIMIT = 110 
.VALUE_MIN_ RANGE = 120 


.- VALUE_NOT_ ESTABLISHED = 130 
. VALUE SERVERDOWN = 140 


.VALUE_ STARTUP VALUE = 150 
.VALUE_TIMEOUT = 160 

End With 

End Sub 

See also 


VALUE_MIN_LIMIT Property (Page 2510) 
VariableStateChecked Property (Page 2545) 
VALUE_TIMEOUT Property (Page 2520) 
VALUE_STARTUP_VALUE Property (Page 2518) 
VALUE_SERVERDOWN Property (Page 2516) 
VALUE_NOT_ESTABLISHED Property (Page 2514) 
VALUE_MIN_RANGE Property (Page 2512) 
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VALUE_MAX_RANGE Property (Page 2508) 
VALUE_INVALID_KEY Property (Page 2502) 
VALUE_HARDWARE_ERROR Property (Page 2498) 
VALUE_HANDSHAKE_ERROR Property (Page 2496) 
VALUE_CONVERSION_ERROR Property (Page 2494) 
VALUE_ADDRESS_ERROR Property (Page 2472) 
VALUE_ACCESS_FAULT Property (Page 2470) 
VariableStateValue Object (Page 2096) 


VALUE_MAX_RANGE Property 


Description 


2508 


Defines or returns the value that will be assigned to the dynamic property if tag status "Format 


upper limit exceeded" occurs. 


The value of the VariableStateChecked property must be TRUE in order for the status to be 


evaluated. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. The dynamization takes place be evaluating the status of a tag. If the tag does not 
return a status, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA777 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of variablestate 
-VariableStateChecked = Tru 

End With 

With objDynDialog.VariableStateValues (1) 


‘define a value for every state: 
.VALUE_ACCESS FAULT = 20 

. VALUE_ADDRESS ERROR = 30 

. VALUE CONVERSION ERROR = 40 


. VALUE_HANDSHAKE ERROR = 60 


. VALUE_ HARDWARE ERROR = 70 
. VALUE_INVALID KEY = 80 


.VALUE_MAX LIMIT = 90 
.VALUE_MAX RANGE = 100 
.VALUE_MIN_ LIMIT = 110 
.VALUE_MIN_ RANGE = 120 


. VALUE OT ESTABLISHED = 130 
.VALUE_SERVERDOWN = 140 

. VALUE STARTUP VALUE = 150 
.VALUE_TIMEOUT = 160 
End With 

End Sub 


See also 
VariableStateChecked Property (Page 2545) 
VALUE_TIMEOUT Property (Page 2520) 
VALUE_STARTUP_VALUE Property (Page 2518) 
VALUE_SERVERDOWN Property (Page 2516) 
VALUE_NOT_ESTABLISHED Property (Page 2514) 
VALUE_MIN_RANGE Property (Page 2512) 
VALUE_MIN_LIMIT Property (Page 2510) 
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VALUE_MAX_LIMIT Property (Page 2506) 
VALUE_INVALID_KEY Property (Page 2502) 
VALUE_HARDWARE_ERROR Property (Page 2498) 
VALUE_HANDSHAKE_ERROR Property (Page 2496) 
VALUE_CONVERSION_ERROR Property (Page 2494) 
VALUE_ADDRESS_ERROR Property (Page 2472) 
VALUE_ACCESS_FAULT Property (Page 2470) 
VariableStateValue Object (Page 2096) 


VALUE_MIN_LIMIT Property 


Description 
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Defines or returns the value that will be assigned to the dynamic property if tag status "Lower 


limit exceeded" occurs. 


The value of the VariableStateChecked property must be TRUE in order for the status to be 


evaluated. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. The dynamization takes place be evaluating the status of a tag. If the tag does not 
return a status, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA778 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of variablestate 
-VariableStateChecked = Tru 

End With 

With objDynDialog.VariableStateValues (1) 


‘define a value for every state: 
.VALUE_ACCESS FAULT = 20 

. VALUE_ADDRESS ERROR = 30 

. VALUE CONVERSION ERROR = 40 


. VALUE_HANDSHAKE ERROR = 60 


. VALUE_ HARDWARE ERROR = 70 
. VALUE_INVALID KEY = 80 


.VALUE_MAX LIMIT = 90 
.VALUE_MAX RANGE = 100 
.VALUE_MIN_ LIMIT = 110 
.VALUE_MIN_ RANGE = 120 


. VALUE OT ESTABLISHED = 130 
.VALUE_SERVERDOWN = 140 

. VALUE STARTUP VALUE = 150 
.VALUE_TIMEOUT = 160 
End With 

End Sub 


See also 
VariableStateChecked Property (Page 2545) 
VALUE_TIMEOUT Property (Page 2520) 
VALUE_STARTUP_VALUE Property (Page 2518) 
VALUE_SERVERDOWN Property (Page 2516) 
VALUE_NOT_ESTABLISHED Property (Page 2514) 
VALUE_MIN_RANGE Property (Page 2512) 
VALUE_MAX_RANGE Property (Page 2508) 
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VALUE_MAX_LIMIT Property (Page 2506) 
VALUE_INVALID_KEY Property (Page 2502) 
VALUE_HARDWARE_ERROR Property (Page 2498) 
VALUE_HANDSHAKE_ERROR Property (Page 2496) 
VALUE_CONVERSION_ERROR Property (Page 2494) 
VALUE_ADDRESS_ERROR Property (Page 2472) 
VALUE_ACCESS_FAULT Property (Page 2470) 
VariableStateValue Object (Page 2096) 


VALUE_MIN_RANGE Property 


Description 
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Defines or returns the value that will be assigned to the dynamic property if tag status "Format 


lower limit exceeded" occurs. 


The value of the VariableStateChecked property must be TRUE in order for the status to be 


evaluated. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. The dynamization takes place be evaluating the status of a tag. If the tag does not 
return a status, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA779 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of variablestate 
-VariableStateChecked = Tru 

End With 

With objDynDialog.VariableStateValues (1) 


‘define a value for every state: 
.VALUE_ACCESS FAULT = 20 
.VALUE_ADDRESS_ ERROR = 30 

. VALUE CONVERSION ERROR = 40 


. VALUE_HANDSHAKE ERROR = 60 


. VALUE_ HARDWARE ERROR = 70 
. VALUE_INVALID KEY = 80 


.VALUE_MAX LIMIT = 90 
.VALUE_MAX RANGE = 100 
.VALUE_MIN_ LIMIT = 110 
.VALUE_MIN_ RANGE = 120 


. VALUE OT ESTABLISHED = 130 
.VALUE_SERVERDOWN = 140 

. VALUE STARTUP VALUE = 150 
.VALUE_TIMEOUT = 160 
End With 

End Sub 


See also 
VariableStateChecked Property (Page 2545) 
VALUE_TIMEOUT Property (Page 2520) 
VALUE_STARTUP_VALUE Property (Page 2518) 
VALUE_SERVERDOWN Property (Page 2516) 
VALUE_NOT_ESTABLISHED Property (Page 2514) 
VALUE_MIN_LIMIT Property (Page 2510) 
VALUE_MAX_RANGE Property (Page 2508) 
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VALUE_MAX_LIMIT Property (Page 2506) 
VALUE_INVALID_KEY Property (Page 2502) 
VALUE_HARDWARE_ERROR Property (Page 2498) 
VALUE_HANDSHAKE_ERROR Property (Page 2496) 
VALUE_CONVERSION_ERROR Property (Page 2494) 
VALUE_ADDRESS_ERROR Property (Page 2472) 
VALUE_ACCESS_FAULT Property (Page 2470) 
VariableStateValue Object (Page 2096) 


VALUE_NOT_ESTABLISHED Property 


Description 


2514 


Defines or returns the value that will be assigned to the dynamic property if tag status "No 
check-back message from the channel" occurs. 


The value of the VariableStateChecked property must be TRUE in order for the status to be 
evaluated. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. The dynamization takes place be evaluating the status of a tag. If the tag does not 
return a status, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA780 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of variablestate 
-VariableStateChecked = Tru 

End With 

With objDynDialog.VariableStateValues (1) 


‘define a value for every state: 
.VALUE_ACCESS FAULT = 20 
.VALUE_ADDRESS_ ERROR = 30 

. VALUE CONVERSION ERROR = 40 


. VALUE_HANDSHAKE ERROR = 60 


. VALUE_ HARDWARE ERROR = 70 
. VALUE_INVALID KEY = 80 


.VALUE_MAX LIMIT = 90 
.VALUE_MAX RANGE = 100 
.VALUE_MIN_ LIMIT = 110 
.VALUE_MIN_ RANGE = 120 


. VALUE OT ESTABLISHED = 130 
.VALUE_SERVERDOWN = 140 

. VALUE STARTUP VALUE = 150 
.VALUE_TIMEOUT = 160 
End With 

End Sub 


See also 
VariableStateChecked Property (Page 2545) 
VALUE_TIMEOUT Property (Page 2520) 
VALUE_STARTUP_VALUE Property (Page 2518) 
VALUE_SERVERDOWN Property (Page 2516) 
VALUE_MIN_RANGE Property (Page 2512) 
VALUE_MIN_LIMIT Property (Page 2510) 
VALUE_MAX_RANGE Property (Page 2508) 
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VALUE_MAX_LIMIT Property (Page 2506) 
VALUE_INVALID_KEY Property (Page 2502) 
VALUE_HARDWARE_ERROR Property (Page 2498) 
VALUE_HANDSHAKE_ERROR Property (Page 2496) 
VALUE_CONVERSION_ERROR Property (Page 2494) 
VALUE_ADDRESS_ERROR Property (Page 2472) 
VALUE_ACCESS_FAULT Property (Page 2470) 
VariableStateValue Object (Page 2096) 


VALUE_SERVERDOWN Property 


Description 
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Defines or returns the value that will be assigned to the dynamic property if tag status "Server 


not available" occurs. 


The value of the VariableStateChecked property must be TRUE in order for the status to be 


evaluated. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. The dynamization takes place be evaluating the status of a tag. If the tag does not 
return a status, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA781 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of variablestate 
-VariableStateChecked = Tru 

End With 

With objDynDialog.VariableStateValues (1) 


‘define a value for every state: 
.VALUE_ACCESS FAULT = 20 

. VALUE_ADDRESS ERROR = 30 

. VALUE CONVERSION ERROR = 40 


. VALUE_HANDSHAKE ERROR = 60 


. VALUE_ HARDWARE ERROR = 70 
. VALUE_INVALID KEY = 80 


.VALUE_MAX LIMIT = 90 
.VALUE_MAX RANGE = 100 
.VALUE_MIN_ LIMIT = 110 
.VALUE_MIN_ RANGE = 120 


. VALUE OT ESTABLISHED = 130 
.VALUE_SERVERDOWN = 140 

. VALUE STARTUP VALUE = 150 
.VALUE_TIMEOUT = 160 
End With 

End Sub 


See also 
VariableStateChecked Property (Page 2545) 
VALUE_TIMEOUT Property (Page 2520) 
VALUE_STARTUP_VALUE Property (Page 2518) 
VALUE_NOT_ESTABLISHED Property (Page 2514) 
VALUE_MIN_RANGE Property (Page 2512) 
VALUE_MIN_LIMIT Property (Page 2510) 
VALUE_MAX_RANGE Property (Page 2508) 
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VALUE_MAX_LIMIT Property (Page 2506) 
VALUE_INVALID_KEY Property (Page 2502) 
VALUE_HARDWARE_ERROR Property (Page 2498) 
VALUE_HANDSHAKE_ERROR Property (Page 2496) 
VALUE_CONVERSION_ERROR Property (Page 2494) 
VALUE_ADDRESS_ERROR Property (Page 2472) 
VALUE_ACCESS_FAULT Property (Page 2470) 
VariableStateValue Object (Page 2096) 


VALUE_STARTUP_VALUE Property 


Description 


2518 


Defines or returns the value that will be assigned to the dynamic property if tag status "Start 


value" occurs. 


The value of the VariableStateChecked property must be TRUE in order for the status to be 


evaluated. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. The dynamization takes place be evaluating the status of a tag. If the tag does not 
return a status, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA782 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of variablestate 
-VariableStateChecked = Tru 

End With 

With objDynDialog.VariableStateValues (1) 


‘define a value for every state: 
.VALUE_ACCESS FAULT = 20 

. VALUE_ADDRESS ERROR = 30 

. VALUE CONVERSION ERROR = 40 


. VALUE_HANDSHAKE ERROR = 60 


. VALUE_ HARDWARE ERROR = 70 
. VALUE_INVALID KEY = 80 


.VALUE_MAX LIMIT = 90 
.VALUE_MAX RANGE = 100 
.VALUE_MIN_ LIMIT = 110 
.VALUE_MIN_ RANGE = 120 


. VALUE OT ESTABLISHED = 130 
.VALUE_SERVERDOWN = 140 

. VALUE STARTUP VALUE = 150 
.VALUE_TIMEOUT = 160 
End With 

End Sub 


See also 
VariableStateChecked Property (Page 2545) 
VALUE_TIMEOUT Property (Page 2520) 
VALUE_SERVERDOWN Property (Page 2516) 
VALUE_NOT_ESTABLISHED Property (Page 2514) 
VALUE_MIN_RANGE Property (Page 2512) 
VALUE_MIN_LIMIT Property (Page 2510) 
VALUE_MAX_RANGE Property (Page 2508) 
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VALUE_MAX_LIMIT Property (Page 2506) 
VALUE_INVALID_KEY Property (Page 2502) 
VALUE_HARDWARE_ERROR Property (Page 2498) 
VALUE_HANDSHAKE_ERROR Property (Page 2496) 
VALUE_CONVERSION_ERROR Property (Page 2494) 
VALUE_ADDRESS_ERROR Property (Page 2472) 
VALUE_ACCESS_FAULT Property (Page 2470) 
VariableStateValue Object (Page 2096) 


VALUE_TIMEOUT Property 


Description 
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Defines or returns the value that will be assigned to the dynamic property if tag status "No 


connection" occurs. 


The value of the VariableStateChecked property must be TRUE in order for the status to be 


evaluated. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. The dynamization takes place be evaluating the status of a tag. If the tag does not 
return a status, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA783 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of variablestate 
-VariableStateChecked = Tru 

End With 

With objDynDialog.VariableStateValues (1) 


‘define a value for every state: 
.VALUE_ACCESS FAULT = 20 

. VALUE_ADDRESS ERROR = 30 

. VALUE CONVERSION ERROR = 40 


. VALUE_HANDSHAKE ERROR = 60 


. VALUE_ HARDWARE ERROR = 70 
. VALUE_INVALID KEY = 80 


.VALUE_MAX LIMIT = 90 
.VALUE_MAX RANGE = 100 
.VALUE_MIN_ LIMIT = 110 
.VALUE_MIN_ RANGE = 120 


. VALUE OT ESTABLISHED = 130 
.VALUE_SERVERDOWN = 140 

. VALUE STARTUP VALUE = 150 
.VALUE_TIMEOUT = 160 
End With 

End Sub 


See also 
VariableStateChecked Property (Page 2545) 
VALUE_STARTUP_VALUE Property (Page 2518) 
VALUE_SERVERDOWN Property (Page 2516) 
VALUE_NOT_ESTABLISHED Property (Page 2514) 
VALUE_MIN_RANGE Property (Page 2512) 
VALUE_MIN_LIMIT Property (Page 2510) 
VALUE_MAX_RANGE Property (Page 2508) 
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VALUE_MAX_LIMIT Property (Page 2506) 
VALUE_INVALID_KEY Property (Page 2502) 
VALUE_HARDWARE_ERROR Property (Page 2498) 
VALUE_HANDSHAKE_ERROR Property (Page 2496) 
VALUE_CONVERSION_ERROR Property (Page 2494) 
VALUE_ADDRESS_ERROR Property (Page 2472) 
VALUE_ACCESS_FAULT Property (Page 2470) 
VariableStateValue Object (Page 2096) 


VALUE_UNCERT_ENGVHIGHLIM Property 


Description 


2522 


Specifies the value assigned to a dynamized property if quality code "uncertain, engineering 
unit range violation, high limit set" occurs, or returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 
TRUE. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


VALUE_BAD_PROCRELSUB Property (Page 2492) 
QualityCodeStateChecked Properties (Page 2390) 
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VBA for Automated Configuration 


3.6 VBA Reference 


VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VALUE_UNCERT_ENGVLOWLIM Property 


Description 
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Specifies the value assigned to a dynamized property if quality code "uncertain, engineering 
unit range violation, low limit set" occurs, or returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 
TRUE. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
QualityCodeStateChecked Properties (Page 2390) 
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VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VALUE_UNCERT_ENGVONLIM Property 


Description 


2526 


Specifies the value assigned to a dynamized property if quality code "uncertain, engineering 
unit range violation, on limits set" occurs, or returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 
TRUE. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


VALUE_UNCERT_SIMVAL Property (Page 2540) 
QualityCodeStateChecked Properties (Page 2390) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 2527 


VBA for Automated Configuration 


3.6 VBA Reference 


VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VALUE_UNCERT_INITVAL Property 


Description 


2528 


Specifies a value assigned to a dynamized property if quality code "uncertain, initial value" 
occurs, or returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 
TRUE. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


VALUE_UNCERT_LUV Property (Page 2530) 
QualityCodeStateChecked Properties (Page 2390) 
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VBA for Automated Configuration 


3.6 VBA Reference 


VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VALUE_UNCERT_LUV Property 


Description 
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Specifies a value assigned to a dynamized property if quality code "uncertain, last usable 
value" occurs, or returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 
TRUE. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


VALUE_HIGHLIMITED Property (Page 2500) 
QualityCodeStateChecked Properties (Page 2390) 
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VBA for Automated Configuration 


3.6 VBA Reference 


VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VALUE_UNCERT_MAINTDEM Property 


Description 


2532 


Specifies a value assigned to a dynamized property if quality code "uncertain, maintenance 
demanded" occurs, or returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 
TRUE. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
QualityCodeStateChecked Properties (Page 2390) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 2533 


VBA for Automated Configuration 


3.6 VBA Reference 


VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VALUE_UNCERT_MISCSTATES Property 


Description 


2534 


Specifies the value assigned to a dynamized property if quality code "uncertain miscellaneous 
states" occurs, or returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 
TRUE. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


VALUE_LOWLIMITED Property (Page 2504) 
QualityCodeStateChecked Properties (Page 2390) 
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VBA for Automated Configuration 


3.6 VBA Reference 


VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VALUE_UNCERT_NONSPECIFIC Property 


Description 


2536 


Specifies the value assigned to a dynamized property if quality code "uncertain, non-specific" 
occurs, or returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 
TRUE. 
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VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


VALUE_UNCERT_MAINTDEM Property (Page 2532) 
QualityCodeStateChecked Properties (Page 2390) 
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VBA for Automated Configuration 


3.6 VBA Reference 


VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VALUE_UNCERT_PROCRELNOM Property 


Description 


2538 


Specifies the value assigned to a dynamized property if quality code "uncertain, process 
related, no maintenance" occurs, or returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 
TRUE. 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


VALUE_BAD_COMMNUV Property (Page 2476) 
QualityCodeStateChecked Properties (Page 2390) 
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VBA for Automated Configuration 


3.6 VBA Reference 


VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VALUE_UNCERT_SIMVAL Property 


Description 


2540 


Specifies a value assigned to a dynamized property if quality code "uncertain, simulated value" 
occurs, or returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 
TRUE. 
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Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


VALUE_BAD_PROCRELNOM Property (Page 2490) 
QualityCodeStateChecked Properties (Page 2390) 
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VALUE_UNCERT_SUBSTSET Property (Page 2542) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MISCSTATES Property (Page 2534) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VALUE_UNCERT_SUBSTSET Property 


Description 
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Specifies a value assigned to a dynamized property if quality code "uncertain, substitute set" 
occurs, or returns its value. 


In order for the quality code to be analyzed, the QualityCodeStateChecked property must be 
TRUE. 
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Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. Dynamization uses the analysis of the quality code of a tag. If the tag fails to return a 
quality code, a substitute value (ElseCase property) is defined: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
'VBA770 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
""NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of qualitycodestate 
-QualityCodeStateChecked = Tru 

End With 

With objDynDialog.QualityCodeStateValues (1) 


"define a value for every state: 
.VALUE_BAD_COMMLUV = 20 

. VALUE_BAD_ COMMNUV = 30 

. VALUE_BAD CONFERROR = 40 

. VALUE BAD DEVICE = 60 


. VALUE BAD | ISCSTATES. = 70 

. VALUE BAD NONSPECIFIC = 80 

. VALUE BAD NOTCONNECTED = 90 

. VALUE BAD OUTOFSERV = 100 

. VALUE BAD PROCRELNOM = TO 

. VALUE BAD PROCRELSUB = 120 

. VALUE HIGHLIMITED = 130 

. VALUE LOWLIMITED = TAQ 

. VALUE _UNCERT E GVHIGHLIM = 150 
. VALUE _UNCERT ENGVLOWLIM = Ted 
- VALUE _UNCERT INITVAL = 170 
.VALUE_UNCERT_LUV = 180 

. VALUE _UNCERT | [AINTDEM = 190 
.VALUE_UNCERT MISCSTATES = 200 
. VALUE _UNCERT NONSPECIFIC = 210 
VALUE _UNCERT PROCRELNOM = 220 
VALUE _UNCERT SIMVAL = 230 
VALUE _UNCERT SUBSTSET = 240 
End With 

End Sub 

See also 


VALUE_UNCERT_MISCSTATES Property (Page 2534) 
QualityCodeStateChecked Properties (Page 2390) 
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VALUE_UNCERT_SIMVAL Property (Page 2540) 
VALUE_UNCERT_PROCRELNOM Property (Page 2538) 
VALUE_UNCERT_NONSPECIFIC Property (Page 2536) 
VALUE_UNCERT_MAINTDEM Property (Page 2532) 
VALUE_UNCERT_LUV Property (Page 2530) 
VALUE_UNCERT_INITVAL Property (Page 2528) 
VALUE_UNCERT_ENGVONLIM Property (Page 2526) 
VALUE_UNCERT_ENGVLOWLIM Property (Page 2524) 
VALUE_UNCERT_ENGVHIGHLIM Property (Page 2522) 
VALUE_LOWLIMITED Property (Page 2504) 
VALUE_HIGHLIMITED Property (Page 2500) 
VALUE_BAD_PROCRELSUB Property (Page 2492) 
VALUE_BAD_PROCRELNOM Property (Page 2490) 
VALUE_BAD_OUTOFSERV Property (Page 2488) 
VALUE_BAD_NOTCONNECTED Property (Page 2486) 
VALUE_BAD_NONSPECIFIC Property (Page 2484) 
VALUE_BAD_MISCSTATES Property (Page 2482) 
VALUE_BAD_DEVICE Property (Page 2480) 
VALUE_BAD_CONFERROR Property (Page 2478) 
VALUE_BAD_COMMNUV Property (Page 2476) 
VALUE_BAD_COMMLUV Property (Page 2474) 
QualityCodeStateValue Object (Page 2044) 


VariablesExist Property 


Description 


Example: 


See also 


2544 


TRUE when all the tags used in the source code of a DynamicDialog object are defined. Read 
only access. 


You can use this property to check whether all the tags that you have defined in the source 
code of the Dynamic dialog are created in WinCC. 


DynamicDialog Object (Page 1955) 
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VariableStateChecked Property 


Description 


TRUE if the status of the specified tag is used in the dynamic dialog for dynamization. 
BOOLEAN write-read access. 


Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. The dynamization takes place be evaluating the status of a tag. If a tag does not return 
a status, a substitute value (ElseCase property) is defined, a tag name is issued and three 
analog value ranges are created: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
"VBA785 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
"'NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of variablestate 
-VariableStateChecked = Tru 

End With 

With objDynDialog.VariableStateValues (1) 


‘define a value for every state: 
.VALUE_ACCESS FAULT = 20 

. VALUE_ADDRESS_ERROR = 30 

. VALUE_CONVERSION_ ERROR = 40 

. VALUE HANDSHAKE ERROR = 60 

. VALUE HARDWARE ERROR = 70 

- VALUE INVALID KEY = 80 


x 


.VALUE_MAX LIMIT = 90 
.VALUE_MAX RANGE = 100 
.VALUE_MIN_ LIMIT = 110 
.VALUE_MIN_RANGE = 120 


- VALUE NOT ESTABLISHED = 130 
.VALUE_SERVERDOWN = 140 

. VALUE STARTUP VALUE = 150 
.VALUE_ TIMEOUT = 160 

nd With 

nd Sub 


mb 


See also 
DynamicDialog Object (Page 1955) 
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VariableStateType Property 


Description 

Returns the type of tag monitoring used to dynamize a property or an event: No monitoring, 

quality code, or tag status. Read only access. 

VariableStateType 

0 hmiNoVariableState 

1 hmiVariableQCState 

2 hmiVariableState 
Example: 


The procedure "GetVariableStateType()" reads the type of monitoring from the current 
document. In this example, the type of monitoring is output in a message: 


Sub GetVariableStateType () 


'VBA819 

Dim objDyn As HMIDynamicDialog 

Set objDyn = 
ActiveDocument.Properties ("Width") .CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
"'TestvVval'") 


sgBox objDyn.VariableStateType 
objDyn.Delete 
End Sub 


See also 
DynamicDialog Object (Page 1955) 


VariableStateValues Property 


Description 


Returns the VariableStateValues listing. Use the VariableStateValues property with the Item 
property to assign a value to the tag status to be used for dynamization. 
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Example: 


In the following example the radius of a circle will be dynamically configured using the Dynamic 
dialog. The dynamization takes place be evaluating the status of a tag. If a tag does not return 
a status, a substitute value (ElseCase property) is defined, a tag name is issued and three 
analog value ranges are created: 


Sub AddDynamicDialogToCircleRadiusTypeAnalog () 
"VBA786 

Dim objDynDialog As HMIDynamicDialog 

Dim objCircle As HMICircle 


Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("Circle A", "HMICircle") 
Set objDynDialog = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeDynamicDialog, 
"'NewDynamicl'") 


With objDynDialog 
-ResultType = hmiResultTypeAnalog 
-AnalogResultInfos.ElseCase = 200 


"Activate analysis of variablestate 
-VariableStateChecked = Tru 

End With 

With objDynDialog.VariableStateValues (1) 


‘define a value for every state: 
. VALUE _ACCESS FAULT = 20 

. VALUE_ADDRESS ERROR = 30 

. VALUE_CONVERSION_ERROR = 40 
- VALUE HANDSHAKE RROR = 60 
. VALUE_ HARDWARE ERROR = 70 

. VALUE INVALID KEY = 80 

. VALUE MAX LIMIT = 90 

. VALUE MAX RANGE 100 
.VALUE_MIN_ LIMIT = 110 

.- VALUE _MIN RANGE = 120 

. VALUE OT ESTABLISHED = 130 
. VALUE SERVERDOWN = 140 

- VALUE STARTUP VALUE = 150 


x 


HH 


See also 
VariableStateValues Object (Listing) (Page 2097) 
DynamicDialog Object (Page 1955) 
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VariableTriggers Property 


Description 


Returns the VariableTriggers listing. Use the VariableTriggers property in order to add a tag 
trigger to a VB action or C action. 


Example: 


In the following example the radius of a circle is made dynamic with the aid of a VB script. A 
tag trigger is used as the trigger: 


Sub DynamicWithVariableTrigger () 

'VBA787 

Dim objVBScript As HMIScriptInfo 

Dim objVarTrigger As HMIVariableTrigger 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument .HMIObjects.AddHMIObject ("Circle VariableTrigger", 
"HMTCircle") 

Set objVBScript = objCircle.Radius.CreateDynamic (hmiDynamicCreationTypeVBScript) 
With objVBScript 

'Triggername and cycletime are defined by add-methode 

Set objVarTrigger = .Trigger.VariableTriggers.Add("VarTrigger", hmiVariableCycleType 10s) 
-SourceCode = "™" 

End With 

End Sub 


See also 
VariableTriggers Object (Listing) (Page 2101) 


VarName Property 


Description 


Defines the tag whose status is to be used in the Dynamic dialog for the purpose of dynamics, 
or returns the name. 
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Example: 


In this example the name of the trigger tag used for creating dynamics in the radius of a circle 
will be output: 


Sub GetVarName () 

"VBA788 

Dim objVBScript As HMIScriptInfo 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument.HMIObjects.Item("Circle VariableTrigger") 
Set objVBScript = objCircle.Radius.Dynamic 

With objVBScript 

"Reading out of variablename 

sgBox "The radius is dynamicabled with: " & .Trigger.VariableTriggers.Item(1) .VarName 
End With 

End Sub 


See also 
VariableStateValue Object (Page 2096) 


VBAVersion Property 


Description 


Returns the VBA version number. Read only access. 


Example: 


In the following example the current VBA version number is output: 


Sub ShowVBAVersion () 

"VBA789 

sgBox Application.VBAVersion 
End Sub 


See also 
Application Object (Page 1909) 
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VBE Property 


Description 
Returns the VB Extensibility object. Read access. 


Example: 


See also 


Application Object (Page 1909) 


Version Property 


Description 
Returns the version number of the specified application. Read only access. 


Example: 
In the following example the version number of the Graphics Designer is output: 


Sub ShowVersionOfGraphicsDesigner () 
"VBA791 

sgBox Application.Version 

End Sub 


See also 
Application Object (Page 1909) 


Views Property 


Description 
Returns the Views listing. Use the Views listing to create a new copy of a picture, for instance. 
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Example: 


In the following example a copy of the active picture is created and then activated: 


Sub AddView() 

"VBA792 

Dim objView As HMIView 

Set objView = ActiveDocument.Views.Add 
objView.Activate 


End Sub 
See also 
Views Object (Listing) (Page 2103) 
Visible Property 
Description 
TRUE if the specified object is intended to be visible. BOOLEAN write-read access. 
Example: 


In the following example a circle will be inserted into the active picture. This circle is not 
intended to be visible in Runtime: 


Sub HideCircleInRuntime () 


"VBA793 

Dim objCircle As HMICircle 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("myCircle", "“HMICircle") 
objCircle.Visible = False 

End Sub 
See also 


Toolbarltem Object (Page 2083) 
Menultem Object (Page 2013) 
HMIObject Object (Page 1988) 
Document Object (Page 1949) 
Toolbar Object (Page 2080) 
Menu Object (Page 2009) 
Application Object (Page 1909) 
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Defines or returns the high limit value "Warning High" in the case of the BarGraph object. 


The "CheckWarningHigh" property must be set to "True" in order for the limit value to be 


The display on reaching the limit value and the type of evaluation are defined via the properties 


W-Z 
WarningHigh Property 
Description 
monitored. 
ColorWarningHigh and TypeWarningHigh. 
Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the high limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 


triggered at a value of "75". 


Sub BarGraphLimitConfiguration () 
"VBA794 
Dim objBarGraph As HMIBarGraph 


Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 


With objBarGraph 

"Set analysis = absolute 
.TypeWarningHigh = False 
"Activate monitoring 
.CheckWarningHigh = True 
"Set barcolor = "red" 
-ColorWarningHigh = RGB(255, 0, 0) 
"Set upper limit = "75" 
-WarningHigh = 75 

End With 

End Sub 


See also 
TypeWarningHigh Property (Page 2458) 
ColorWarningHigh Property (Page 2192) 
CheckWarningHigh Property (Page 2178) 
BarGraph Object (Page 1914) 
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WarningLow Property 


Description 
Defines or returns the low limit value "Warning Low" in the case of the BarGraph object. 


The "CheckWarningLow" property must be set to "True" in order for the limit value to be 
monitored. 


The display on reaching the limit value and the type of evaluation are defined via the properties 
ColorWarningLow and TypeWarningLow. 


Example: 


The "BarGraphLimitConfiguration()" procedure configures the properties of the low limit value 
for an alarm. In this example the type of evaluation will be set to "Absolute". The alarm will be 
triggered at a value of "12". 


Sub BarGraphLimitConfiguration () 

"VBA795 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "“HMIBarGraph") 
With objBarGraph 

"Set analysis = absolute 

.TypeWarningLow = False 

"Activate monitoring 


-CheckWarningLow = True 

"Set barcolor = "magenta" 
-ColorWarningLow = RGB(255, 0, 255) 
"Set lower limit = "12" 

-WarningLow = 75 

End With 

End Sub 
See also 


TypeWarningLow Property (Page 2459) 
ColorWarningLow Property (Page 2193) 
CheckWarningLow Property (Page 2179) 
BarGraph Object (Page 1914) 


Width Property 
Description 


Defines or returns the width of an object in pixels. 
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Example: 


In the following example three objects of different sizes will be inserted in the active picture. 
Then all objects will be selected and set to the same width: 


Sub ApplySameWidthToSelectedObjects () 

"VBA796 

Dim objCircle As HMICircle 

Dim objRectangle As HMIRectangle 

Dim objEllipse As HMIEllipse 

Set objCircle = ActiveDocument.HMIObjects.AddHMIObject ("SCircle", "“HMICircle") 
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject ("SRectangle", "HMIRectangle") 
Set objEllipse = ActiveDocument.HMIObjects.AddHMIObject ("SEllipse", "HMIEllipse") 
With objCircle 

-Top = 30 

-Left = 0 

-Width = 15 

-Selected = Tru 

End With 

With objRectangle 

-Top = 80 

-Left = 42 

-Width = 40 

-Selected = Tru 

End With 

With objEllipse 

-Top = 48 

-Left = 162 

-Width = 120 

-BackColor = RGB(255, 0, O) 

-Selected = Tru 

End With 

sgBox "Objects selected!" 

ActiveDocument.Selection.SameWidth 


End Sub 
See also 
HMIObject Object (Page 1988) 
WinCCStyle property 
Description 


Defines the style in which the object is displayed. 


User-defined Shows the object according to the respective settings. 
global Shows the object in a globally defined design. 
Windows Style Shows the object in Windows style. 
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TRUE if it is intended that the application window or picture window shall be displayed with a 


Example 
WindowBorder Property 
Description 
border in Runtime. BOOLEAN write-read access. 
Example: 


The "ApplicationWindowConfig" procedure accesses the properties of the application window. 


In this example the application window will 


Sub ApplicationWindowConfig() 
'VBA797 
Dim objAppWindow As HMIApplicationWindow 


Set objAppWindow = ActiveDocument.HMIObjects.AddHMIObject ("AppWindow", 


"HMTApplicationWindow") 
With objAppWindow 
-Caption = True 
-CloseButton = False 
-Height = 200 


-Left = 10 
-MaximizeButton = True 
-Moveable = False 
-OnTop = True 
-Sizeable = True 
-Top = 20 

-Visible = True 
-Width = 250 
.-WindowBorder = True 
End With 

End Sub 

See also 


PictureWindow Object (Page 2029) 
ApplicationWindow Object (Page 1911) 
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WindowMonitorNumber property 


Description 
Defines the monitor on which the picture window is displayed. This requires that the system 
supports more than one monitor. The attribute is only effective if the "Independent window" 
attribute is set to "Yes". 
1-n |The number of the monitor in the operating system on which the picture window is 
displayed. 
Example 


WindowPositionMode property 


Description 
Defines the position and scaling of the picture window on the screen. The property is only 
effective if the "Independent window" attribute is set to "Yes". 
Standard The picture window is positioned in its original size in the configured position 

on the screen. 

Center The picture window is positioned in its original size, centered on the screen. 
Maximize The picture window is scaled to the size of the screen. 

Example 
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WindowsStyle property 


Description 


Example 


Defines whether the object is displayed in the Windows style of WinCC version 6.2. It can only 
be selected if "WinCC Classic" is chosen as the current design. 


yes Shows the object using the Windows style from WinCC version 6.2. 
No Shows the object not using the Windows style from WinCC version 6.2. 


WindowState Property 


Description 


Example: 


Returns the status of the window containing the specified application. READ access. 


WindowState Assigned Value 
Maximized 0 
Minimized 1 
Custom sized 2 


In the following example the window status of the Graphics Designer is output: 


Sub ShowWindowState () 


'VBA798 
Dim strState As 


String 


Select Case Application.WindowState 


Case 0 
strState 
Case 1 
strState = "The 
Case 2 
strState = "The 
End Select 
sgBox strState 
End Sub 


"The 
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application-window is maximized" 


applicationwindow is minimized" 


application-window has a userdefined size" 


ANSI-C, VBA) 
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Defines or returns the position of the zero point on the bar in the case of the BarGraph object. 


Specify the value as a %age of the total bar height. The zero point can also be outside of the 


The "ScalingType" property must be set to "2" and "Scaling" must be set to "True". 


See also 
Application Object (Page 1909) 
ZeroPoint Property 
Description 
range represented. 
Example: 


The "BarGraphConfiguration()" procedure configures In this example the zero point is located 


halfway up the bar height: 


Sub BarGraphConfiguration() 
"VBA799 
Dim objBarGraph As HMIBarGraph 


Set objBarGraph = ActiveDocument .HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 


With objBarGraph 
-Scaling = True 
-ScalingType = 2 
-ZeroPoint = 50 
-ZeroPointValue = 0 
End With 

End Sub 


See also 


ZeroPointValue Property (Page 2559) 


ScalingType Property (Page 2406) 
Scaling Property (Page 2405) 
BarGraph Object (Page 1914) 
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ZeroPointValue Property 


Description 


Defines or returns the absolute value for the zero point. 


Example: 


The "BarGraphConfiguration()" procedure configures In this example the absolute value of the 
zero point will be set to "0". 


Sub BarGraphConfiguration () 

"'VBA800 

Dim objBarGraph As HMIBarGraph 

Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject ("Barl", "HMIBarGraph") 
With objBarGraph 

-Scaling = True 

-ScalingType = 2 

.ZeroPointValue = 0 

End With 

End Sub 


See also 
ZeroPoint Property (Page 2558) 
ScalingType Property (Page 2406) 
Scaling Property (Page 2405) 
BarGraph Object (Page 1914) 
3DBarGraph Object (Page 1894) 


Zoom Property 


Description 


Defines or returns the zoom factor. 
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Example: 


In this example a copy of the active picture is created and the zoom factor is set to 50%: 


Sub CreateViewFromActiveDocument () 
"VBA801 

Dim objView As HMIView 

Set objView = ActiveDocument.Views.Add 
objView.Zoom = 50 


End Sub 
See also 
View Object (Page 2102) 
PictureWindow Object (Page 2029) 
3.6.2 VBA in Other WinCC Editors 
3.6.2.1 VBA in Other WinCC Editors 
Introduction 


In addition to Graphics Designer, you can automate the following WinCC editors with VBA: 
e Tag Management 

e Tag Logging 

e Text library 

e Alarm Logging 


The functions for accessing the editors are contained in the "HMIGO" class. 


Requirement 


e The "HMIGenObjects.dll" file is referenced. This happens automatically during WinCC 
installation. 


Principle 


For access to the "HMIGO" class with VBA, you must reference the "HMI GeneralObjects 1.0 
Type Library" in the VBA editor via the "Tools > References" menu. You must create a new 
instance of this class in the program code, e.g.: 


"Dim HMIGOObject As New HMIGO 
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Create several different objects of this class if access several objects at the same time. Two 
instances of the "HMIGO" class are required, for example, in Tag Logging: The first instance 
is required for access to the archive tags, the second instance for access to the process value 
archive. 


To enable you to use the functions and properties of the editors in VBA, you must have opened 
a project in WinCC. 


You can then, for example, do the following directly from the program code: 
@ Create several tags and change the values 
e Edit text entries in the TextLibrary 


e Adapt messages. 


Querying Object State 


Error Handling 


Sub CreateTag() 
"HMIGO_000 


The "HMIGO" class has the enumeration "HMIGO_OBJECT_STATE" which returns the state 
of the specified object. The enumeration can return the following values: 


e OBJECT_EMPTY (2): Connection to the object is not available. 


e OBJECT_OPENED (3): Connection to objects exists. You can change and read its 
parameters. 


¢ OBJECT_MODIFIED (4): An object's parameters have been changed. If the corresponding 
Commit function is not called, the changes are not saved. 


@e WINCC_CONNECTED (1): The object is connected to the WinCC project. By default this 
connection is established when a function is called the first time. To release the connection, 
use the instruction "HMIGO = nothing", for example. 


Errors can occur when you use the "HMIGO" class. Use the "OnError" statement to respond 
to these error messages. The "OnError" statement must come before the call of a function 
from the HMIGeneralObjects class: 


Dim hmiGOTag as New HMIGO 

On Error GoTo ErrorHandlerHMIGO 

hmiGOTag.CreateTag "NewTag", TAG BINARY TAG, "ExistingConnection", "DB1,DD0,QC", 
"NewOrExistingGroupName" 


Exit Sub 


sgBox ("Error: 
Resume Next 
End Sub 
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ErrorHandlerHMIGO: 


""& Err.Number & " " & Err.Description & " " & Err.Source) 


ANSI-C, VBA) 
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As a result, an error text returned by the interface is output. 


See also 
VBA in Alarm Logging (Page 2622) 
VBA in the Text Library (Page 2608) 
VBA in Tag Logging (Page 2573) 
VBA in Tag Management (Page 2562) 
3.6.2.2 VBA in Tag Management 


VBA in Tag Management 


Introduction 


VBA can be used to: 


Create tags directly from the program code 
Modify and delete tags 

Read out and change the properties of the tags 
Read out and change the types of the tags 


Read out and change the values of the tags 


Note 


The tags may not be open or opened in tag management when editing with VBA. 

If you wish to change the data type of a tag, you must first delete the tag and then regenerate 
it. You must save the parameters first in order to be able to transfer them following the 
generation of tags. 


Principle 


When you have created the instance of the "HMIGO" class, the following functions are available 
to you to access the tag management facility: 
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CloseTag 
CommitTag 
CreateTag 
DeleteTag 
GetTag 
ListTag 
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The following enumerations are available for the parameter supply of these functions: 
@ HMIGO_TAG_TYPE 
@¢ HMIGO_TAG_LIST_TYPE 


Note 


If you set the start value to a binary tag, use the values "0" or "1". Do not use the values "False" 
or "True". These values are no longer valid for VBA programming in WinCC and will result in 


an error message. 


Replace the values "False" and "True" with "0" and "1" in your existing VBA code. 


Access to the Object Properties 


You can also access the parameters of the above-mentioned functions directly in VBA by 
means of the following object properties: 


Object property Description Read/Write 
ObjectStateTag Returns the object state via the enumeration HMIGO_OB- Yes/no 
JECT_STATE. Further information on this enumeration can 
be found in this documentation under "VBA in other WinCC 
Editors". 
TagName Name of the tag Yes/no 
TagGroupName Name of a group in which the tag is inserted. If the group does | Yes/no 
not yet exist, it is created. If no group name is specified, the 
tag is created outside all groups. 
TagConnection Name of a connection in which the tag and/or group is to be | Yes/no 
created. The connection must already be in existence, other- 
wise a tag cannot be created. If the name is omitted, an in- 
ternal tag is created. 
TagMaximum Sets the new value of the upper limit Yes/yes 
TagMinimum Sets the new value of the lower limit Yes/yes 
TagStart Sets the new start value Yes/yes 
TagS5S7Address Address of the S7 or S5 PLC to which the tag is connected. | Yes/yes 
If no address is specified, a blank entry is passed. 
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Object property Description Read/Write 
TagType Data type of the tag. The possible types are: Yes/no 
(HMI- e TAG_BINARY_TAG (1) 


GO_TAG_TYPE 
7 . ) e TAG_SIGNED_8BIT_VALUE (2) 


e TAG_UNSIGNED_8BIT_VALUE (3) 

e TAG_SIGNED_16BIT_VALUE (4) 

e TAG_UNSIGNED_16BIT_VALUE (5) 

e TAG_SIGNED_32BIT_VALUE (6) 

e TAG_UNSIGNED_32BIT_VALUE (7) 

e TAG_FLOATINGPOINT_NUMBER_32BIT_IEEE_754 (8) 
e TAG_FLOATINGPOINT_NUMBER_64BIT_IEEE_754 (9) 
e TAG_TEXT_TAG_8BIT_CHARACTER_SET (10) 

e TAG_TEXT_TAG_16BIT_CHARACTER_SET (11) 

e TAG_RAW_DATA_TYPE (12) 

e TAG_STRUCT (14) 

e TAG_TEXT_REFERENCE (18) 


TagUpdate Defines whether the tag is updated on the local computer or | Yes/yes 
(HMIGO_TAG_UP- for the entire project. (for internal tag only) 
DATE) e TAG_COMPUTER_LOCAL (1) 
© TAG_PROJECT_WIDE (2) 
LengthText Length of a text tag (0...255) yes/yes 


"LengthText" can also be used for the length of the raw data | (only for exter- 
tag. A testing of the correctness of the length will not be con- | nal tag of type 
ducted. Observe the instructions of the communication chan- | text) 


nels. 
TagScaleValid Defines a linear scaling. Yes/yes 
TagScaleParam1 Sets the value’ for the value range process. Yes/yes 
TagScaleParam2 Sets the value2 for the value range process. Yes/yes 
TagScaleParam3 Sets the value’ for the value range tag. Yes/yes 
TagScaleParam4 Sets the value2 for the value range tag. Yes/yes 
TagStartvaluePersis- | Defines whether an internal tag is set as persistent. Yes/yes 
tence 
TagSubst Replacement value (only for external variables) Yes/yes 
UseSubstValueOn- Set the replacement value for connection errors. Yes/yes 
CommonError 
UseSubstValueOn- Set the replacement value for upper limit. Yes/yes 
MaxLimit 
UseSubstValueOn- Set the replacement value for lower limit. Yes/yes 
MinLimit 
UseSubstValueOn- Set the replacement value for the start value. Yes/yes 
StartValue 
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You will find a description of the properties under the parameter descriptions for the 
corresponding functions. 


Note 


The "Tag synchronization" point in the property dialog of tags is not addressable with VBA. 
Tag synchronization is only available for internal tags. 


For external tags, the "Type Conversion" point is not addressable with VBA. 


See also 
ListTag function (Page 2572) 
GetTag Function (Page 2571) 
DeleteTag Function (Page 2570) 
CreateTag Function (Page 2568) 
CommitTag Function (Page 2566) 
CloseTag Function (Page 2565) 
VBA in Other WinCC Editors (Page 2560) 


CloseTag Function 


Description 

Closes the open tag. 

Note 

Modified parameters are not saved. 
Syntax 

Expression.CloseTag() 

Expression 

Necessary. An expression which returns a "HMIGO" type object. 
Parameters 
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Example: 


Sub CloseTag() 
' HMIGO_001 
" procedure to close a variable 
" tag need to be created befor 
' declarations 
Dim objJHMIGO As HMIGO 
Dim strVariableName As String 
Set objJHMIGO = New HMIGO 
strVariableName = "NewVariable" 
"current status is "EMPTY" 
MsgBox objHMIGO.ObjectStateTag, vbOKOnly, "Status Variable" 
‘open a tag 
objJHMIGO.GetTag strVariableName 
"current status is "OPENED" 
MsgBox objHMIGO.ObjectStateTag, vbOKOnly, "Status Variable" 
‘open a tag 
objJHMIGO.CloseTag 
"current status is "EMPTY" 
MsgBox objHMIGO.ObjectStateTag, vbOKOnly, "Status Variable" 


Set objJHMIGO = Nothing 
End Sub 


See also 
ListTag function (Page 2572) 
GetTag Function (Page 2571) 
DeleteTag Function (Page 2570) 
CreateTag Function (Page 2568) 
CommitTag Function (Page 2566) 
VBA in Tag Management (Page 2562) 


CommitTag Function 


Description 
Writes the changed parameters of the open tag to WinCC. 


Note 


If further parameters are changed after a CommitTag call, write the changes to WinCC by 
calling this function again. 
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Parameters 
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Expression 


Expression.CommittTag () 
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Necessary. An expression which returns a "HMIGO" type object. 


Sub CommitTag () 


" HMIGO 002 

' procedure to change a property of a variable 
" tag need to be created befor 

' declarations 


Dim objJHMIGO As HMIGO 
Dim strVariableName As String 


Set objJHMIGO = New HMIGO 
strVariableName = "NewVariable" 
"current status is "EMPTY" 


MsgBox objHMIGO.Objec 


‘open a tag 


tStateTag, 


objHMIGO.GetTag strVariableName 


"current status is 
MsgBox objH 


"change a property 
objHMIGO.TagStart = 1 


"current sta 
MsgBox objH 
"commit a tag 


objJHMIGO.CommitTag 


"current sta 
MsgBox objH 


Set objJHMIGO = 


End Sub 


See also 


"OPENED" 

IGO.ObjectStateTag, 
g 0 
tus is "MODIFIED" 
IGO.ObjectStateTag, 
tus is "OPENED" 
IGO.ObjectStateTag, 

Nothing 


vbOKOnly, 


vbOKOnly, 


vbOKOnly, 


vbOKOnly, 


ListTag function (Page 2572) 
GetTag Function (Page 2571) 
DeleteTag Function (Page 2570) 
CreateTag Function (Page 2568) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 


"Status 


"Status 


"Status 


"Status 


Variable" 


Variable" 


Variable" 


Variable" 


2567 


VBA for Automated Configuration 
3.6 VBA Reference 


CloseTag Function (Page 2565) 
VBA in Tag Management (Page 2562) 


CreateTag Function 


Description 
Creates a new tag. 
syntax 
Expression.CreateTag (TagName, TagType, [Connection], [S7S5Address], 
[GroupName ] ) 
Expression 
Necessary. An expression which returns a "HMIGO" type object. 
Parameters 
Parameter (Data Type) Description 
TagName (string) Name of the tag to be created. 
TagType (HMIGO_TAG_TYPE) Data type of the tag. The possible types are: 


TAG_BINARY_TAG 
TAG_SIGNED_8BIT_VALUE 
TAG_UNSIGNED_8BIT_VALUE 
TAG_SIGNED_16BIT_VALUE 
TAG_UNSIGNED_16BIT_VALUE 
TAG_SIGNED_32BIT_VALUE 
TAG_UNSIGNED_32BIT_VALUE 
TAG_FLOATINGPOINT_NUM- 
BER_32BIT_IEEE_754 
TAG_FLOATINGPOINT_NUM- 
BER_64BIT_IEEE_754 
TAG_TEXT_TAG_8BIT_CHARACTER_SET 
TAG_TEXT_TAG_16BIT_CHARACTER_SET 
TAG_RAW_DATA_TYPE 
TAG_TEXT_REFERENCE 


Connection (String, optional) Name of a connection in which the tag and/or 
group is to be created. The connection must al- 
ready be in existence, otherwise a tag cannot be 
created. 

If the name is omitted, an internal tag and/or group 
is recreated. 
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Parameter (Data Type) 
$7S5Address (String, optional) 


Description 


Address of the S7 or S5 PLC to which the tag is 
connected. Without an address indication, an emp- 
ty entry will be handed over. 

The parameter "S7S5Address" must be supple- 
mented by the string ",\QC"for the configuration of 
the Quality Code, for example: "DB1,DD0,QC". 

If the Quality Code of the tag is no longer to be 
monitored, the string ",\QC" must be deleted. 


GroupName (String, optional) 


Name of a group in which the tag is inserted. If the 
group does not exist, it will be newly created. 

If the group name is not indicated, the tag will be 
created outside all groups. 


Example: 


Sub CreateTag() 

' HMIGO_ 003 

' procedure to create a variable 

" tag must not be created befor 

' declarations 
Dim objJHMIGO As HMIGO 
Dim strVariableName As String 
Set objJHMIGO = New HMIGO 
strVariableName = "NewVariable" 
"current status is "EMPTY" 


MsgBox objHMIGO.ObjectStateTag, vbOKOnly, "Status Variable" 


"create a tag 


objHMIGO.CreateTag strVariableName, TAG SIGNED 32BIT VALUE 


"current status is "OPENED" 


MsgBox objHMIGO.ObjectStateTag, vbOKOnly, "Status Variable" 


Set objJHMIGO = Nothing 
End Sub 


See also 
ListTag function (Page 2572) 
GetTag Function (Page 2571) 
DeleteTag Function (Page 2570) 
CommitTag Function (Page 2566) 
CloseTag Function (Page 2565) 
VBA in Tag Management (Page 2562) 
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DeleteTag Function 


Description 

Deletes the specified tag. 
syntax 

Expression.DeleteTag (TagName) 

Expression 

Necessary. An expression which returns a "HMIGO" type object. 
Parameters 

Parameter (Data Type) Description 

TagName (string) Name of the tag to be deleted. 
Example: 


Sub DeleteTag() 

' HMIGO_004 

" procedure to delete a variable 

" tag need to be created befor 

' declarations 
Dim objJHMIGO As HMIGO 
Dim strVariableName As String 
Set objHMIGO = New HMIGO 
strVariableName = "NewVariable" 
‘current status is "EMPTY" 
MsgBox objHMIGO.ObjectStateTag, 


"delete a tag 


objHMIGO.DeleteTag strVariableName 


Set objJHMIGO = Nothing 


End Sub 
See also 
ListTag function (Page 2572) 
GetTag Function (Page 2571) 
CreateTag Function (Page 2568) 
CommitTag Function (Page 2566) 
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CloseTag Function (Page 2565) 
VBA in Tag Management (Page 2562) 


GetTag Function 


Description 
Reads in the parameters of the specified tag. 
You can change or read the parameters by means of the object properties. You will find a list 
of the available object properties in this documentation under "VBA in Tag Management". 
syntax 
Expression.GetTag (TagName) 
Expression 
Necessary. An expression which returns a "HMIGO" type object. 
Parameters 
Parameter (Data Type) Description 
TagName (string) Name of the tag whose values are to be read in. 
Example: 
Sub GetTag () 
' HMIGO_005 


' procedure to open a variable 


" tag need to be created befor 
' declarations 
Dim objJHMIGO As HMIGO 
Dim strVariableName As String 
Set objJHMIGO = New HMIGO 
strVariableName = "NewVariable" 
‘current status is "EMPTY" 
MsgBox objHMIGO.ObjectStateTag, vbOKOnly, "Status Variable" 
"open/ get a tag 
objHMIGO.GetTag strVariableName 
"current status is "OPENED" 
MsgBox objHMIGO.ObjectStateTag, vbOKOnly, "Status Variable" 
Set objJHMIGO = Nothing 
End Sub 
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See also 


ListTag function (Page 2572) 
DeleteTag Function (Page 2570) 
CreateTag Function (Page 2568) 


CommitTag Function (Page 2566) 
CloseTag Function (Page 2565) 
VBA in Tag Management (Page 2562) 


ListTag function 


Description 
Alternatively, the ListTag function returns the following contents of the Tag Management as a 
list: 
e All the channel units created 
e All the channels created 
e All the connections created 
e All the tag groups created 
e All the tags created 
syntax 
Expression.ListTag(ListType,pListArray, [Filter] ) 
Expression 
Necessary. An expression which returns a "HMIGO" type object. 
Parameters 
Parameter (Data Type) Description 
ListType (HMIGO_TAG_LIST_TYPE) Defines which content should be returned as a list. 
Possibilities are: 
@ TAG_CHANNEL_UNITS (0) all channel units 
created 
e TAG_CHANNELS (2) all channels created 
e TAG_CONNECTIONS (3) all connections 
created 
e TAG_GROUPS (4) all tag groups created 
e TAG_NAMES (5) all tags created 
pListArray (Variant) List with the requested content. 
Filter (String) Filters can be set optionally. Wildcards "*" and "?" 
are also possible. 
WinCC: Scripting (VBS, ANSI-C, VBA) 
2572 System Manual, 02/2016, A5E37536061-AA 


VBA for Automated Configuration 
3.6 VBA Reference 


Example: 


In the following example, a check is made whether the list with the connections created is 
empty because no connections have been set up: 


Sub ReadTagByConnection() 
"HMIGO_027 
"read content in data manager by connections 
"no conections are implemented 
Dim objJHMIGO As New HMIGO 
Dim varRange As Variant 
‘read all connections 
objJHMIGO.ListTag TAG CONNECTIONS, arrContent 


"check result 
If (UBound(arrContent) - LBound(arrContent) + 1) <= 0 Then 
MsgBox "no entries because no connections are implemented" 
End If 
End Sub 
See also 


GetTag Function (Page 2571) 
DeleteTag Function (Page 2570) 
CreateTag Function (Page 2568) 
CommitTag Function (Page 2566) 
CloseTag Function (Page 2565) 

VBA in Tag Management (Page 2562) 


3.6.2.3 VBA im Tag Logging 


VBA in Tag Logging 


Introduction 


VBA allows you to create process value archives, archive tags and triggers directly from the 
program code, modify them, and delete them. 


Note 
You should not have or should not open the "Tag Logging" editor when editing with VBA. 
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Principle 
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When you have created the instance of the "HMIGO" class, the following functions are available 
to you to access Tag Logging: 


CloseTlgArchive 
CloseTlgTag 
CloseTlgTrigger 
CommitTlgArchive 
CommitTlgTag 
CommitTlgTrigger 
CreateTIgArchive 
CreateTlgTag 
CreateTlgTrigger 
DeleteTlgArchive 
DeleteTlgTag 
DeleteTlgTrigger 
GetTlgArchive 
GetTlgTag 
GetTlgTrigger 
ListTlgArchive 
ListTlgTag 
ListTlgTrigger 


The following enumerations are available for the parameter supply of these functions: 


HMIGO_TLG_ARCHIVE_TYPE 
HMIGO_TLG_ARCHIVE_LIST_TYPE 
HMIGO_TLG_TAG_TYPE 
HMIGO_TLG_TAG_LIST_TYPE 
HMIGO_TLG_TRIGGER_BASE 
HMIGO_TLG_TRIGGER_LIST_TYPE 
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You can also access the parameters of the above-mentioned functions directly in VBA by 
means of the following object properties. The column "is used in" will display whether you will 
be able to access the object property in the process value archive (P) and/or in the compressed 


archive (V). 
Object property 


ObjectStateTlgArchive 


ObjectStateTlgTag 


Description 


Returns the object state for the archive via the enumera- 
tion "HMIGO_OBJECT_STATE". Further information on 
this enumeration can be found in this documentation un- 
der "VBA in other WinCC Editors". 


Returns the object state for the archive tag via the enu- 
meration "HMIGO_OBJECT_STATE". 


Read/ 
Write 


Yes/no 


Yes/no 


is used in 


P,V 


P,V 


TlgArchiveAccessLevelRead 


The authorization level for reading. 


Yes/no 


P,V 


TlgArchiveAccessLevelWrite 
TIgArchiveArchiveState 


The authorization level for writing. 


Specifies whether archiving is disabled or enabled at 
system startup. Possible values of the enum "HMI- 
GO_TLG_ARCHIVE_STATE": 


e TLG_ARCHIVE_STATE_LOCKED (1) 
e TLG_ARCHIVE_STATE_ACTIVATED (0) 


Yes/no 
Yes/yes 


P,V 
P,V 


TIgArchiveBufferSize 


Specifies the number of records for a short-term archive. 


Yes/yes 


TigArchiveBufferT ype 


Specifies the tag storage location. The possible types of 
the enum "HMIGO_TLG_ARCHIVE_BUFFER_TYPE": 


e TLG_ARCHIVE_BUFFER_TYPE_DISK (2) 
e TLG_ARCHIVE_BUFFER_TYPE_RAM (1) 


Yes/yes 


TlgArchiveCompressRange 


Specifies the compression time period. Name of the tim- 
er, greater than or equal to 1, defined under "Times" in 
the Tag Logging editor. Since the format is a string, it is 
language dependent. 

Can be determined via the function "ListTlgArch- 
ive(TLG_ARCHIVE_TRIGGER_NAMES, arrTrigger)" 


Yes/yes 


TlgArchiveCompressType 


TlgArchiveFlags 


Specifies the algorithm for compressing the values. The 
possible types of the enum "HMIGO_TLG_AR- 
CHIVE_COMPRESS_TYPE": 


@ TLG_COMPRESS_TYPE_CALC (1) 

@ TLG_COMPRESS_TYPE_CALC_COPY (2) 

@ TLG_COMPRESS_TYPE_CALC_DEL (3) 

e TLG_COMPRESS_TYPE_CALC_COPY_DEL (4) 
Used internally. 


Yes/yes 


TIgArchiveName 


Name of the process value archive or compressed ar- 
chive. 


Yes/no 


P,V 
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Object property 


TIlgArchiveQCRActive 


Description 


Specifies for the compressed archive whether weighted 
quality codes are used during archiving. The possible 
types of the enum "HMIGO_TLG_QCR_AC- 
TIVE_FLAGS": 


e TLG_QCR ALL (15) 
e TLG_QCR_BAD (1) 

¢ TLG_QCR_GOOD_CASCADED (8) 

e TLG_QCR_GOOD_NONCASCADED (4) 
e TLG_QCR_OFF (0) 

e TLG_QCR_UNCERTAIN (2) 


Read/ 
Write 


is used in 


Vv 


TIlgArchiveQCRBad 


If weighted quality codes are used and the "Bad" option 
is activated, you define for the compression archive the 
percentage as of which the "Bad" state of process values 
is archived in the compression tag. 


TIlgArchiveQCRGoodCascade 


If weighted quality codes are used and the "Good (Cas- 
cade)" option is activated, you define for the compression 
tag the percentage as of which the "Good (Cascade)" 
state of process values is archived in the compression 
tag. 


TIgArchiveQCRGoodNonCas- 
cade 


If weighted quality codes are used and the "Good (Non- 
Cascade)" option is activated, you define for the com- 
pression archive the percentage as of which the "Good 
(Non-Cascade)" state of process values is archived in 
the compression tag. 


TIlgArchiveQCRUncertain 


If weighted quality codes are used and the "Uncertain" 
option is activated, you define for the compression ar- 
chive the percentage as of which the "Uncertain" state of 
process values is archived in the compression tag. 


TIgArchiveType 


Specifies whether the archive is a process value archive 
or a compressed archive. 


Yes/no 


TlgTagAliasName 


The alternative name by means of which the tag can be 
addressed (alias). 


Yes/yes 


TlgTagArchiveName 


Name of the archive. 


Yes/no 


TIlgTagArchiving 


Specifies the acquisition type. Possible values of the 
enum "HMIGO_TLG_TAG_ARCHIVING": 


e TLG_TAG_ACYCLIC (8388609) 

e TLG_TAG_CYCLIC_CONTINUOUS (8388610) 
e TLG_TAG_CYCLIC_SELECTIVE (8388612) 

e TLG_TAG_ON_EVERY_CHANGE (8388616) 


Yes/yes 


TIgTagArchivingState 


Specifies whether archiving is enabled or disabled at 
system startup. Possible values of the enum "HMI- 
GO_TLG_TAG_ARCHIVING_STATE": 


e TLG_TAG_LOCKED (1) 
e TLG_TAG_ACTIVATED (0) 


Yes/yes 


P,V 


TlgTagConvertModule 


Name of the conversion DLL used for data conversion. 


Yes/yes 
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Object property 


TlgTagFlags 


Description 


Possible values of the enum "HMI- 
GO_TLG_TAG_FLAGS'": 


e TLG_TAG_LONGTERM_DISABLED (1) 
e TLG_TAG_NOFLAGS (0) 


Read/ 
Write 


is used in 


TlgTagHysterese 


Value for the hysteresis by means of which a check is 
carried out to establish whether a value has changed. 


Yes/yes 


TlgTagLowerLimit 


Value for the scaling of the tag's lower limit. 


Yes/yes 


TlgTagMethodType 


Specifies the method by which the value is edited before 
archiving. Possible values of the enum "HMI- 
GO_TLG_TAG_METHOD_TYPE": 


e TLG_TAG_ACTUAL (1) 
e TLG_TAG_SUM (3) 

e TLG_TAG_MaxValue (5) 
e TLG_TAG_MinValue (4) 

e TLG_TAG_AVERAGE (2) 


Yes/yes 


TlgTagName 


Name of the archive tag. 


Yes/no 


TlgTagNameCompressArchive 


In the case of compressed archives, contains the name 
of the source archive. 


Yes/yes 


TIlglagNameCompressTag 


In the case of compressed archives, contains the name 
of the source tag. 


Yes/yes 


TlgTagNameProcTag 


Name of the process tag from which the value to be ac- 
quired is taken. 


Yes/yes 


TilgTagNameRawValue 


In the cast of process-controlled archives, contains the 
name of the raw-data tag. 


Yes/yes 


TlgTagOnChange 


Specifies whether archiving is to be carried out in the 
event of a change. Possible values of the enum "HMI- 
GO_TLG_TAG_ON_CHANGE": 


e TLG_TAG_EVERY_VALUE (0) 
e TLG_TAG_RELATIVE_HYSTERESE (1) 
e TLG_TAG_ABSOLUTE_HYSTERESE (2) 


Yes/yes 


TlgTagOnError 


Specifies whether, in the event of a problem, the most 
recently acquired value or the substitute value is saved. 
Possible values of the enum "HMI- 
GO_TLG_TAG_ON_ERROR": 


e TLG_TAG_LAST_VALUE (1) 
e TLG_TAG_SUBSTITUTE (2) 


Yes/yes 


TlgTagPreviousOSGUID 


Used internally. 
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Object property Description Read/ is used in 
Write 


TlgTagQCRActive Specifies for the compression tag whether weighted qual- V 
ity codes are used during archiving. The possible types 
of the enum "HMIGO_TLG_QCR_ACTIVE_FLAGS": 


e TLG_QCR ALL (15) 
e TLG_QCR_BAD (1) 

e TLG_QCR_GOOD_CASCADED (8) 

¢ TLG_QCR_GOOD_NONCASCADED (4) 
e TLG_QCR_OFF (0) 

e TLG_QCR_UNCERTAIN (2) 


TlgTagQCRBad If weighted quality codes are used and the "Bad" option Vv 
is activated, you define for the compression tag the per- 
centage as of which the "Bad" state of process values is 
archived in the compression tag. 


TlgTagQCRGoodCascade If weighted quality codes are used and the "Good (Cas- Vv 
cade)" option is activated, you define for the compression 
tag the percentage as of which the "Good (Cascade)" 
state of process values is archived in the compression 
tag. 


TlgTagQCRGoodNonCascade If weighted quality codes are used and the "Good (Non- Vv 
Cascade)" option is activated, you define for the com- 
pression tag the percentage as of which the "Good (Non- 
Cascade)" state of process values is archived in the com- 
pression tag. 


TlgTagQCRUncertain If weighted quality codes are used and the "Uncertain" V 
option is activated, you define for the compression tag 
the percentage as of which the "Uncertain" state of proc- 
ess values is archived in the compression tag. 


TlgTagSDCompressDeviation Specifies the absolute or relative value of the deviation, P 
which is permitted for the calculation of the increase by 
the algorithm. Basic value is the process value saved last. 


TlgTagSDCompression Specifies whether the swinging door compression is ac- P 
tivated. 


TlgTagSDLowLimit Specifies the low limit of the swinging door compression P 
distribution when a relative deviation is activated. 


TlgTagSDRelativeDecision Specifies whether the relative value of the deviation is P 
taken into consideration at the swinging door algorithm. 


TlgTagSDtMax Specifies the maximum duration between two archived P 
values as the detection limit for swinging door compres- 
sion. 


TlgTagSDtMin Specifies the minimum duration between two archived P 
values as the detection limit for swinging door compres- 
sion. 


TlgTagSDUpperLimit Specifies the upper limit of the swinging door compres- P 
sion distribution when a relative deviation is activated. 


TlgTagStartEvent Name of the tag by means of which the start of archiving | Yes/yes P 
is checked. 
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Object property 


TlgTagStartTriggerFunction 


Description 


Specifies the name ofa script function by means of which 
a check is carried out for a start event for the start of 
archiving. 


Read/ 
Write 


Yes/yes 


is used in 


TlgTagStopEvent 


Name of the tag by means of which the stopping of ar- 
chiving is checked. 


Yes/yes 


TlgTagStopTriggerFunction 


Specifies the name of a script function by means of which 
a check is carried out for a stop event for the start of 
archiving. 


Yes/yes 


TlgTagTriggerArchiving 
TlgTagTriggerFactor 


Name of the timer for the archiving cycle. 


Contains the factor for the display cycle as a multiple of 
the archiving cycle. 


Yes/yes 
Yes/yes 


TlgTagTriggerFunction 


Specifies the name of a script function for the dynamic 
switching of the acquisition and archiving cycles. 


Yes/yes 


TlgTagTriggerScan 


Name of the timer for the acquisition cycle 


Yes/yes 


TlgTagTriggerType 


Specifies how archiving is carried out at a signal change. 
Possible values of the enum "HMIGO_TLG_TAG_TRIG- 
GER_TYPE": 


e TLG_TAG_FROM_0_TO_1 (2) 

e TLG_TAG_FROM_1_TO_0 (3) 

e TLG_TAG_ALWAYS (4) 

e TLG_TAG_EVERY_CHANGE (1) 


Yes/yes 


TlgTagType 


Specifies the tag type. The possible types of the enum 
"HMIGO_TLG_TAG_TYPE": 


e TLG_TAG_TYP_ANALOG (65537) 

e TLG_TAG_TYP_BINARY (65538) 

e TLG_TAG_TYP_PROCESS (65544) 
e TLG_TAG_TYP_COMPRESS (65540) 


Yes/yes 


P,V 


TlgTagUpperLimit 


Value for the scaling of the tag's upper limit. 


Yes/yes 


TigTriggerBase 


Time base for the trigger. Possible values of the enum 
"HMIGO_TLG_TRIGGER_BASE": 


e TLG_TRIGGER_BASE_250MS (250) 

e TLG_TRIGGER_BASE_500MS (500) 

e TLG_TRIGGER_BASE_DAY (&H5265C00) 
e TLG_TRIGGER_BASE_HOUR (&H36EE80) 
e TLG_TRIGGER_BASE_MIN (&HEA60) 

e TLG_TRIGGER_BASE_SEC (&H3E8) 


TigTriggerCreatorID 


Used internally. 


TigTriggerFactor 


Integer factor that is taken into consideration for the trig- 
ger together with the time base. 


TlgTriggerName 


Name of the trigger. 


TlgTriggerScheduleDayOfMonth 


Specifies the day for the trigger for the "Monthly" time 
series. 
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Object property Description Read/ is used in 
Write 


TlgTriggerScheduleDaysOfWeek | Specifies the days for the trigger for the "Weekly" time P 

series. Possible values of the enum "HMIGO_TLG_TRIG- 

GER_SCHEDULE_DAYSOFWEEk": 

e TLG_TRIGGER_SCHEDULE_DAYSOFWEEK_EVE 
RY_DAY (127) 

e TLG_TRIGGER_SCHEDULE_DAYSOFWEEK _FRI 
DAY (32) 

e TLG_TRIGGER_SCHEDULE_DAYSOFWEEK_MO 
NDAY (2) 

e TLG_TRIGGER_SCHEDULE_DAYSOFWEEK_NO_ 
DAY (0) 

e TLG_TRIGGER_SCHEDULE_DAYSOFWEEK_SAT 
URDAY (64) 

e TLG_TRIGGER_SCHEDULE_DAYSOFWEEK_SUN 
DAY (1) 

e TLG_TRIGGER_SCHEDULE_DAYSOFWEEK_THU 
RSDAY (16) 

e TLG_TRIGGER_SCHEDULE_DAYSOFWEEK_TUE 
SDAY (4) 

e TLG_TRIGGER_SCHEDULE_DAYSOFWEEK_WE 
DNESDAY (8) 


TlgTriggerSchedulelnterval Specifies the interval for the trigger for the calendar times. P 


TlgTriggerScheduleMonthOf- Specifies the month for the trigger for the "Yearly" time P 
Year series. 


TlgTriggerScheduleType Defines the type of trigger. Possible time series of the P 
enum "HMIGO_TLG_TRIGGER_SCHEDULE_TYPE": 


e TLG_TRIGGER_SCHEDULE_TYPE_CYCLIC (0) 

e TLG_TRIGGER_SCHEDULE_TYPE_DAILY (1) 

e TLG_TRIGGER_SCHEDULE_TYPE_MONTHLY (3) 
e TLG_TRIGGER_SCHEDULE_TYPE_WEEKLY (2) 
e TLG_TRIGGER_SCHEDULE_TYPE_YEARLY (4) 


TlgTriggerStartByShutdown The trigger is initiated additionally when the system is P 
shut down regardless of the configured triggers. 


TigTriggerStartByStartup The trigger is initiated additionally when the system is P 
started up regardless of the configured triggers. 

TigTriggerStartDay Specifies the day for the starting point of the trigger. P 

TlgTriggerStartHour Specifies the hour for the starting point of the trigger. P 

TigTriggerStartMilliSecond Specifies the milliseconds for the starting point of the P 
trigger. 

TigTriggerStartMinute Specifies the minute for the starting point of the trigger. P 

TigTriggerStartMonth Specifies the month for the starting point of the trigger. P 

TlgTriggerStartSecond Specifies the seconds for the starting point of the trigger. P 

TigTriggerStartYear Specifies the year for the starting point of the trigger. P 
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See also 


ListTlgTag Function (Page 2606) 
ListTlgArchive Function (Page 2604) 
GetTlgArchive Function (Page 2601) 
DeleteTIlgTag Function (Page 2599) 
DeleteTlgArchive Function (Page 2598) 
CreateTIgTag Function (Page 2592) 
CreateTIgArchive Function (Page 2589) 
CommitTlgTag Function (Page 2587) 
CommitTlgArchive Function (Page 2585) 
CloseTlgTag Function (Page 2583) 
CloseTlgArchive Function (Page 2581) 
VBA in Other WinCC Editors (Page 2560) 
CloseTlgTrigger function (Page 2584) 
CommitTlgTrigger function (Page 2589) 
CreateTlgTrigger function (Page 2596) 
DeleteTlgTrigger function (Page 2600) 
GetTlgTrigger function (Page 2604) 
ListTlgTrigger function (Page 2607) 


CloseTlgArchive Function 


Description 


syntax 


Parameters 


3.6 VBA Reference 


Closes the process value or compressed archive which is open. 


Note 


Modified parameters are not saved. 


Expression.CloseTlgArchive () 


Expression 


Necessary. An expression which returns a "HMIGO" type object. 
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Example: 


Sub CloseTlgArchive () 


' HMIGO 006 


" procedure to 
' 


the archive n 


close an archive 
d to be created befor 


' declarations 


Dim objJHMIGO 


As HMIGO 


Dim strArchiveName As String 


Set objHMIGO = New HMIGO 
strArchiveName = "NewArchive" 
"current status is "EMPTY" 


MsgBox objHMI 
‘open archive 
obj HMIGO.GetT 
"current statu 
MsgBox objHMI 
"close archive 
obj HMIGO.Clos 
"current statu 
MsgBox objHMI 


Set objJHMIGO 
End Sub 


See also 


2582 


GO.ObjectStateTlgArchive, vbOKOnly, 


lgArchive strArchiveName 
s is "OPENED" 
GO.ObjectStateTlgArchive, vbOKOnly, 


eTlgArchive 
s is "EMPTY" 
GO.ObjectStateTlgArchive, vbOKOnly, 


= Nothing 


ListTlgTag Function (Page 2606) 
ListTlgArchive Function (Page 2604) 
GetTlgArchive Function (Page 2601) 
DeleteTlgTag Function (Page 2599) 
DeleteTlgArchive Function (Page 2598) 
CreateTlgTag Function (Page 2592) 
CreateTlgArchive Function (Page 2589) 
CommitTlgTag Function (Page 2587) 
CommitTlgArchive Function (Page 2585) 
CloseTlgTag Function (Page 2583) 
VBA in Tag Logging (Page 2573) 


"Status Tlg Archive" 


"Status Tlg Archive" 


"Status Tlg Archive" 
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CloseTlgTag Function 


Description 
Closes the archive tag which is open. 
Note 
Modified parameters are not saved. 
syntax 
Expression.CloseTlgTag() 
Expression 
Necessary. An expression which returns a "HMIGO" type object. 
Parameters 
Example: 


Sub CloseTlgTag() 
' HMIGO_ 007 

' procedure to close a tag logging tag 

the archive need to be created befor 

the tag logging tag need to be created befor 
declarations 

Dim objJHMIGO As HMIGO 

Dim strArchiveName As String 

Dim strTlgTagName As String 

Set objHMIGO = New HMIGO 

strArchiveName = "NewArchive" 

strTlgTagName = "NewTag" 


‘current status is "EMPTY" 
MsgBox objHMIGO.ObjectStateTlgTag, vbOKOnly, "Status Tlg Tag" 
‘open/ get tag logging tag 
objHMIGO.GetTlgTag strArchiveName, strTlgTagName 
"current status is "OPENED" 
MsgBox objHMIGO.ObjectStateTlgTag, vbOKOnly, "Status Tlg Archive" 
"close tag logging tag 
objJHMIGO.CloseTlgTag 
"current status is "EMPTY" 
MsgBox objHMIGO.ObjectStateTlgTag, vbOKOnly, "Status Tlg Archive" 
Set objJHMIGO = Nothing 
End Sub 
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See also 


ListTlgTag Function (Page 2606) 
ListTlgArchive Function (Page 2604) 
GetTlgArchive Function (Page 2601) 
DeleteTlgTag Function (Page 2599) 
DeleteTlgArchive Function (Page 2598) 
CreateTIgTag Function (Page 2592) 
CreateTlgArchive Function (Page 2589) 
CommitTlgTag Function (Page 2587) 
CommitTlgArchive Function (Page 2585) 
CloseTlgArchive Function (Page 2581) 
VBA in Tag Logging (Page 2573) 


CloseTlgTrigger function 


Description 


Syntax 


Parameter 


2584 


Closes the opened trigger. 


Note 


Modified parameters are not saved. 


Expression.CloseTlgTrigger () 


Expression 


Required. An expression which returns a "HMIGO" type object. 
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CommitTlgArchive Function 


Description 


Writes the changed parameters of the specified archive to WinCC. 


Note 


If further parameters are changed after a CommitTlgArchive call, write the changes to WinCC 
by calling this function again. 


syntax 


Expression.CommitTlgArchive () 


Expression 
Necessary. An expression which returns a "HMIGO" type object. 


Parameters 
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Example: 


Sub CommitTlgArchive () 


' HMIGO 008 


" the archiv 


procedure to change a property of an archive 


d to be created befor 


' declarations 


n 


Dim objJHMIGO As HMIGO 
Dim strArchiveName As String 


Set objJHMIGO 


= New HMIGO 


strArchiveName = "NewArchive" 
"current status is "EMPTY" 


MsgBox objHMIGO.ObjectStateTlgArchive, 


‘open archive 


obj HMIGO.GetTlgArchive strArchiveName 


"current status is 
MsgBox objHMIGO.ObjectStateTlgArchive, 
"change a property 
objJHMIGO.TlgArchiveArchiv 
"current status is 
MsgBox objHMIGO.ObjectStateTlgArchive, 
‘commit archive 


"OPENE 


D" 


vbOKOnly, 


vbOKOnly, 


Stat 


= TLG STATE 


| LOCKE 


"MODIFIED" 


objJHMIGO.CommitTlgArchive 


"current status is 
MsgBox objHMIGO.ObjectStateTlgArchive, 


Set objHMIGO 
End Sub 


See also 


2586 


Dp" 


"OPENE 


= Nothing 


DeleteTIgArchive Function (Page 2598) 
ListTlgTag Function (Page 2606) 
ListTlgArchive Function (Page 2604) 
GetTlgArchive Function (Page 2601) 
DeleteTlgTag Function (Page 2599) 
CreateTlgTag Function (Page 2592) 
CreateTlgArchive Function (Page 2589) 
CommitTlgTag Function (Page 2587) 
CloseTIlgTag Function (Page 2583) 
CloseTlgArchive Function (Page 2581) 
VBA in Tag Logging (Page 2573) 


vbOKOnly, 


vbOKOnly, 


"Status 


"Status 


D 


"Status 


"Status 


Tlg Archive" 


Tlg Archive" 


Tlg Archive" 


Tlg Archive" 
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CommitTlgTag Function 


Description 


Writes the changed parameters of the specified archive tag to WinCC. 


Note 


If further parameters are changed after a CommitTlgTag call, write the changes to WinCC by 
calling this function again. 


syntax 


Expression.CommitTlgTag () 


Expression 
Necessary. An expression which returns a "HMIGO" type object. 


Parameters 
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Example: 


Sub CommitTlgTag() 

" HMIGO 009 

procedure to change a property of a tag logging tag 
" the archive need to be created befor 

'" the tag logging tag need to be created befor 
' declarations 

Dim objJHMIGO As HMIGO 

Dim strArchiveName As String 

Dim strTlgTagName As String 

Set objJHMIGO = New HMIGO 

strArchiveName = "NewArchive" 

strTlgTagName = "NewTag" 


"current status is "EMPTY" 
MsgBox objHMIGO.ObjectStateTlgTag, vbOKOnly, "Status Tlg Tag" 
open/ get tag logging tag 
objHMIGO.GetTlgTag strArchiveName, strTlgTagName 
"current status is "OPENED" 
MsgBox objHMIGO.ObjectStateTlgTag, vbOKOnly, "Status Tlg Archive" 
change a property 
objHMIGO.TlgTagArchiving = TLG TAG ON EVERY CHANG 
"current status is "MODIFIED" 
MsgBox objHMIGO.ObjectStateTlgTag, vbOKOnly, "Status Tlg Archive" 
commit tag logging tag 
objJHMIGO.CommitTlgTag 
"current status is "OPENED" 
MsgBox objHMIGO.ObjectStateTlgTag, vbOKOnly, "Status Tlg Archive" 
Set objJHMIGO = Nothing 
End Sub 


Fl 


See also 
ListTlgTag Function (Page 2606) 
ListTlgArchive Function (Page 2604) 
GetTlgArchive Function (Page 2601) 
DeleteTlgTag Function (Page 2599) 
DeleteTIgArchive Function (Page 2598) 
CreateTlgTag Function (Page 2592) 
CreateTlgArchive Function (Page 2589) 
CommitTlgTag Function (Page 2587) 
CommitTlgArchive Function (Page 2585) 
CloseTlgTag Function (Page 2583) 
CloseTlgArchive Function (Page 2581) 
VBA in Tag Logging (Page 2573) 
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CommitTlgTrigger function 


Description 
Writes the changed parameters of the specified trigger to WinCC. 


Note 


If further parameters are changed after a CommitTlgTrigger call, write the changes to WinCC 
by calling this function again. 


Syntax 

Expression.CommitTlgTrigger () 

Expression 

Required. An expression which returns a "HMIGO" type object. 
Parameter 


CreateTlgArchive Function 


Description 
Creates a process value archive or compressed archive. 
syntax 
Expression. CreateTlgArchive (ArchiveName, ArchiveType) 
Expression 
Necessary. An expression which returns a "HMIGO" type object. 
Parameters 
Parameter (Data Type) Description 
ArchiveName (String) Name of the archive to be created 


ArchiveType (HMIGO_TLG_ARCHIVE_TYPE) Type of the archive. The possible types are: 
e TLG_PROCESSARCHIVE (131073) fora 
process value archive 


e@ TLG_COMPRESSARCHIVE (131074) for a 
compressed archive 
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Default Values when Creating a New Tag Archive 


The following table indicates the default values that are entered when a new process value 
archive or compressed archive is created. These values can be modified later and written using 
the CommitTlgArchive function. 


Property Default Value (Enum Name => Val- | Comment 
ue) 
TIgArchiveAccessLevel- 0 Without authorization level 
Read 
TlgArchiveAccessLevel- 0 Without authorization level 
Write 
TIgArchiveArchiveState TLG_ARCHIVE_STATE_ACTIVA- Archiving is started at start of Run- 
TED (0) time. 
TIgArchiveBufferSize 1000 Number of data records 
TlgArchiveBufferT ype TLG_ARCHIVE_BUF- The values are stored on hard disk 
FER_TYPE_DISK (2) in the database. 
TIlgArchiveCompress- "1 Tag". This string must be created | Corresponds to exactly one day. 
Range individually for each language (e.g. | Only relevant in the case of com- 
English: "1 day") pressed tags. 
Special Feature: the user is respon- 
sible for values >= 1 minute 
TIlgArchiveCompressType | TLG_COMPRESS_TYPE_CALC (1) | Only calculate compression val- 
ues. Only relevant in the case of 
compressed tags. 


Enum HMIGO_TLG_ARCHIVE_STATE 


Parameters Description 


TLG_ARCHIVE_STATE_LOCKED (1) Archiving is disabled at system startup. 


TLG_ARCHIVE_STATE_ACTIVATED (0) Archiving is started at start of Runtime. 


Enum HMIGO_TLG_ARCHIVE_BUFFER_TYPE 


Parameters Description 


TLG_ARCHIVE_BUFFER_TYPE_DISK (2) | The values are archived on hard disk. 
TLG_ARCHIVE_BUFFER_TYPE_RAM (1) | The values are only archived in working memory. 


Enum HMIGO_TLG_ARCHIVE_COMPRESS_TYPE 


Parameters Description 


TLG_COMPRESS_TYPE_CALC (1) Only the compression values are calculated. 


TLG_COMPRESS_TYPE_CALC_COPY (2) | The compression values are calculated and the original 
values copied. 
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Parameters 
TLG_COMPRESS_TYPE_CALC_DEL (3) 


Description 


The compression values are calculated and the original 
values then deleted. 


TLG_COM- 
PRESS_TYPE_CALC_COPY_DEL (4) 


The compression values are calculated and the original 
values copied and then deleted. 


Example: 


Sub CreateTlgArchive () 

' HMIGO_ 010 

' procedure to create an archive 

the archive must not be created befor 
declarations 

Dim objJHMIGO As HMIGO 

Dim strArchiveName As String 

Set objHMIGO = New HMIGO 
strArchiveName = "NewArchive" 
‘current status is "EMPTY" 


MsgBox objJHMIGO.ObjectStateTlgArchive, vbOKOnly, "Status Tlg Archive" 


"create tag logging archive 


objJHMIGO.CreateTlgArchive strArchiveName, TLG_PROCESSARCHIVE 


"current status is "OPENED" 


MsgBox objHMIGO.ObjectStateTlgArchive, vbOKOnly, "Status Tlg Archive" 


Set objJHMIGO = Nothing 
End Sub 


See also 
GetTlgArchive Function (Page 2601) 
ListTlgTag Function (Page 2606) 
ListTlgArchive Function (Page 2604) 
DeleteTlgTag Function (Page 2599) 
DeleteTlgArchive Function (Page 2598) 
CreateTIgTag Function (Page 2592) 
CommitTlgTag Function (Page 2587) 
CommitTlgArchive Function (Page 2585) 
CloseTlgTag Function (Page 2583) 
CloseTlgArchive Function (Page 2581) 
VBA in Tag Logging (Page 2573) 
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CreateTlgTag Function 


Description 
Creates a new archive tag. 
Syntax 
Expression.CreateTlgTag (ArchiveName, TagName, [TagType] ) 
Expression 
Required. An expression which returns a "HMIGO" type object. 
Parameter 
Parameter (Data Type) Description 
ArchiveName (String) Name of an existing archive in which the tag is to 
be entered 
TagName (string) Name of the tag to be created 
TagType (HMIGO_TLG_TAG_TYPE, optional) Specifies the type of the tag. If no type is specified, 
the default value TLG_VAR_TYP_ANALOG is en- 
tered. Possible types are: 
e TLG_VAR_TYP_ANALOG (65537) for an 
analog tag. 
e TLG_VAT_TYP_BINARY (65538) for a binary 
tag. 
e TLG_VAR_TYP_PROCESS (65544) fora 
process tag. 
e TLG_VAT_TYP_COMPRESS (65540) for a 
compression tag. 
Default Values When a New Archive Tag Is Created 
The following table indicates the default values that are entered when a new archive tag is 
created. These values can be modified later and written using the CommitTlgTag function. 
Property Default Value (Enum Name => Value) | Note 
TlgTagType TLG_VAR_TYP_ANALOG (65537) Acquired by means of an ana- 
log data manager tag 
TlgTagArchiving TLG_TAG_CYCLIC_CONTINUOUS | Cyclic, continuous acquisition 
(8388610) 
TlgTagArchivingState TLG_TAG_ACTIVATED (0) Archiving is started at start of 
Runtime. 
TigTagTriggerScan 1 second Please note that "1 second" is 
only the name of the trigger. 
You must ensure yourself that 
the trigger exists and actually 
has a cycle of 1 s. 
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Property Default Value (Enum Name => Value) | Note 

TlgTagTriggerArchiving 1 second Please note that '"1 second" is 
only the name of the trigger. 
You must ensure yourself that 
the trigger exists and actually 
has a cycle of 1s. 

TlgTagTriggerFactor 1 The display cycle and archiving 
cycle are identical. 

TlgTagOnError TLG_TAG_LAST_VALUE (1) The last valid value is taken as 
the substitute value. 

TlgTagTriggerType TLG_TAG_ALWAYS (4) Every value is archived. 

TlglagMethodType TLG_TAG_ACTUAL (1) No editing. The value is accep- 


ted immediately. 


TlgTagStartTriggerFunction 


No function specified -- 


TlgTagStopTriggerFunction 


No function specified -- 


TlgTagTriggerFunction No function specified -- 

TlgTagUpperLimit No value specified -- 

TlgTagLowerLimit No value specified -- 

TlglagNameCompres- No archive name specified -- 

sArchive 

TlgfagNameCompressTag | No tag name specified -- 

TlglagNameRawValue No raw data tag specified -- 

TlgTagNameProcTag Corresponds to "TagName" -- 

TlglTagOnChange TLG_TAG_EVERY_VALUE (0) Every value is archived. 
TlgTagHysterese 0 No check is carried out by 


means of hysteresis. 


TlgTagAliasName 


No value specified -- 


TlgTagStartEvent 


No tag specified -- 


TlgTagStopEvent 


No tag specified -- 


List of the enumerators for Tag Logging 


Enum types 
TLG_TAG_TYPE 


TLG_TAG_ARCHIVING 


Description 


The passed parameter specifies the type of the tag. The possible types 
are in the table Enum HMIGO_TLG_TAG_TYPE. 


The passed parameter specifies the acquisition type. The possible 
values are in the table Enum HMIGO_TLG_TAG_ARCHIVING. 


TLG_TAG_ARCHIV- 
ING_STATE 


TLG_TAG_ON_ERROR 


The passed parameter specifies whether archiving is disabled or ena- 
bled at system startup. The possible values are in the table Enum 
HMIGO_TLG_TAG_ARCHIVING_STATE. 


The passed parameter specifies which value is stored in the event of 
a problem: the most recently acquired value or the substitute value. 
The possible values are in the table Enum HMI- 
GO_TLG_TAG_ON_ERROR. 
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Enum types 


TLG_TAG_TRIGGER_TYPE 


Description 


The passed parameter specifies how archiving is carried out at a signal 
change. The possible values are in the table Enum HMI- 
GO_TLG_TAG_TRIGGER_TYPE. 


TLG_TAG_METHOD_TYPE 


The passed parameter specifies the method by which the value is edi- 
ted before archiving. The possible values are in the table Enum HMI- 
GO_TLG_TAG_METHOD_TYPE. 


TLG_TAG_ON_CHANGE 


The passed parameter specifies whether archiving is to be carried out 
in the event of a change. The possible values are in the table Enum 
HMIGO_TLG_TAG_ON_CHANGE. 


Enum HMIGO_TLG_TAG_TYPE 


Values Description 
TLG_TAG_TYP_ANALOG (65537) Analog tag 
TLG_TAG_TYP_BINARY (65538) Binary tag 


TLG_TAG_TYP_PROCESS (65544) 


Process tag 


TLG_TAG_TYP_COMPRESS (65540) 


Compressed archive tag 


Enum HMIGO_TLG_TAG_ARCHIVING 


Values 
TLG_TAG_ACYCLIC (8388609) 


Description 


Acyclic acquisition 


TLG_TAG_CYCLIC_CONTINUOUS (8388610) 


Cyclic-continuous acquisition 


TLG_TAG_CYCLIC_SELECTIVE (8388612) 


Cyclic-selective acquisition 


TLG_TAG_ON_EVERY_CHANGE (8388616) 


Acquisition only in the event of a change 


Enum HMIGO_TLG_TAG_ARCHIVING_STATE 


Values Description 


TLG_TAG_LOCKED (1) 
TLG_TAG_ACTIVATED (0) 


Acquisition disabled at system startup 


Acquisition enabled at system startup 


Enum HMIGO_TLG_TAG_ON_ERROR 


Values Description 


TLG_TAG_LAST_VALUE (1) 


The most recently acquired value is used. 


TLG_TAG_SUBSTITUTE (2) 


A substitute value is entered. 
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Enum HMIGO_TLG_TAG_TRIGGER_TYPE 


Values Description 
TLG_TAG_FROM_0_TO_1 (2) Signal change from the value 0 to 1. 
TLG_TAG_FROM_1_TO_0 (3) Signal change from the value 1 to 0. 
TLG_TAG_ALWAYS (4) Always archive. 
TLG_TAG_EVERY_CHANGE (1) Archive at every signal change. 


Enum HMIGO_TLG_TAG_METHOD_TYPE 


Values Description 
TLG_TAG_ACTUAL (1) The current value is accepted. 
TLG_TAG_SUM (3) The sum is formed. 
TLG_TAG_MaxValue (5) The greatest value is saved. 
TLG_TAG_MinValue (4) The smallest value is saved. 
TLG_TAG_AVERAGE (2) The average value is saved. 


Enum HMIGO_TLG_TAG_ON_CHANGE 


Values Description 

TLG_TAG_EVERY_VALUE (0) The current value is accepted. 
TLG_TAG_RELATIVE_HYSTER- A hysteresis specified as a percentage is used for the calcula- 
ESE (1) tion as to whether the value is to be archived. 
TLG_TAG_ABSOLUTE_HYSTER- A hysteresis specified as an absolute value is used for the cal- 
ESE (2) culation as to whether the value is to be archived. 
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Example 


Sub CreateTlgTag () 


' 


' 


' 


HMIGO_011 


procedure to create a tag logging tag 
the archive need to be created befor 


the tag logging tag must not be created befor 


declarations 

Dim objJHMIGO As HMIGO 

Dim strArchiveName As String 

Dim strTlgTagName As String 

Set objJHMIGO = New HMIGO 
strArchiveName = "NewArchive" 

strTlgTagName = "NewTag" 


‘current status is "EMPTY" 
MsgBox objHMIGO.ObjectStateTlgTag, 
"create tag logging tag 


obj HMIGO.CreateTlgTag strArchiveName, 


"current status is "OPENED" 
MsgBox objHMIGO.ObjectStateTlgTag, 
Set objJHMIGO = Nothing 


End Sub 


See also 


vbOKOnly, 


vbOKOnly, 


ListTlgTag Function (Page 2606) 

ListTlgArchive Function (Page 2604) 
GetTlgArchive Function (Page 2601) 
DeleteTlgTag Function (Page 2599) 
DeleteTlgArchive Function (Page 2598) 
CreateTlgArchive Function (Page 2589) 
CommitTlgTag Function (Page 2587) 


CloseTlgArchive Function (Page 2581) 


CloseTlgTag Function (Page 2583) 
VBA in Tag Logging (Page 2573) 


CreateTlgTrigger function 


Description 


"Status 


strTlgTagName, 


"Status 


Tlg 


m 


ag" 


TLG_ TAG TYPE ANALOG 


Tlg Archive" 


Creates a new trigger that is used as a timer for the acquisition and archiving cycle. 
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Syntax 


Expression 


3.6 VBA Reference 


Required. An expression which returns a "HMIGO" type object. 


Parameter 


Expression.CreateTlgTrigger (TriggerName, TriggerBase, TriggerFactor) 


Parameter (Data Type) Description 


TriggerName (String) Name of the trigger to be created 


TriggerBase (HMIGO_TLG_TRIGGER_BASE) Time base of the trigger. Possible values: 

e TLG_TRIGGER_BASE_250MS (250) 

e TLG_TRIGGER_BASE_500MS (500) 

e TLG_TRIGGER_BASE_DAY (&H5265C00) 
e TLG_TRIGGER_BASE_HOUR (&H36EE80) 
e TLG_TRIGGER_BASE_MIN (&HEA60) 

e TLG_TRIGGER_BASE_SEC (&H3E8) 


TriggerFactor Integer factor that is taken into consideration for the trigger together 
with the time base. 


Enum HMIGO_TLG_TRIGGER_BASE 


Parameter Description 
TLG_TRIGGER_BASE_250MS (250) The time base is "250 ms". 
TLG_TRIGGER_BASE_500MS (500) The time base is "500 ms". 
TLG_TRIGGER_BASE_DAY (&H5265C00) The time base is "1 day". 
TLG_TRIGGER_BASE_HOUR (&H36EE80) The time base is "1 hour". 
TLG_TRIGGER_BASE_MIN (&HEA60) The time base is "1 minute". 
TLG_TRIGGER_BASE_SEC (&H3E8) The time base is "1 second”. 


Enum HMIGO_TLG_TRIGGER_SCHEDULE_DAYSOFWEEK 


Parameter 


TLG_TRIGGER_SCHEDULE_DAYSOFWEEK_EVERY_DAY 
(127) 


Description 
Every day is used for the "Weekly" trigger. 


TLG_TRIGGER_SCHEDULE_DAYSOFWEEK_FRIDAY (32) 


Friday is used for the "Weekly" trigger. 


TLG_TRIGGER_SCHEDULE_DAYSOFWEEK_MONDAY (2) 


Monday is used for the "Weekly" trigger. 


TLG_TRIGGER_SCHEDULE_DAYSOFWEEK_NO_DAY (0) 


No day is used for the "Weekly" trigger. 


TLG_TRIGGER_SCHEDULE_DAYSOFWEEK_SATURDAY (64) 


Saturday is used for the "Weekly" trigger. 


TLG_TRIGGER_SCHEDULE_DAYSOFWEEK_SUNDAY (1) 


Sunday is used for the "Weekly" trigger. 


TLG_TRIGGER_SCHEDULE_DAYSOFWEEK_THURSDAY (16) 


Thursday is used for the "Weekly" trigger. 


TLG_TRIGGER_SCHEDULE_DAYSOFWEEK_TUESDAY (4) 


Tuesday is used for the "Weekly" trigger. 


TLG_TRIGGER_SCHEDULE_DAYSOFWEEK_WEDNESDAY (8) 


Wednesday is used for the "Weekly" trigger. 
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Enum HMIGO_TLG_TRIGGER_SCHEDULE_TYPE 


Parameter 
TLG_TRIGGER_SCHEDULE_TYPE_CYCLIC (0) 


Description 


The time series "Standard (cyclic)" is used for the trigger. 


TLG_TRIGGER_SCHEDULE_TYPE_DAILY (1) 


The time series "Daily" is used for the trigger. 


TLG_TRIGGER_SCHEDULE_TYPE_MONTEHLY (3) 


The time series "Monthly" is used for the trigger. 


TLG_TRIGGER_SCHEDULE_TYPE_WEEKLY (2) 


The time series "Weekly" is used for the trigger. 


TLG_TRIGGER_SCHEDULE_TYPE_YEARLY (4) 


The time series "Yearly" is used for the trigger. 


DeleteTigArchive Function 


Description 

Deletes the specified archive. 
Syntax 

Expression. DeleteTlgArchive (ArchiveName) 

Expression 

Necessary. An expression which returns a "HMIGO" type object. 
Parameters 

Parameter (Data Type) Description 

ArchiveName (String) Name of the archive to be deleted. Archive tags 

contained in the archive are also deleted. 

Example: 


Sub DeleteTlgArchive () 

' HMIGO_012 

' procedure to delete an archive 

" the archive need to be created befor 


' declarations 
Dim objJHMIGO As HMIGO 
Dim strArchiveName As String 
Set objHMIGO = New HMIGO 
strArchiveName = "NewArchive" 
‘current status is "EMPTY" 


MsgBox objHMIGO.ObjectStateTlgArchive, vbOKOnly, "Status Tlg Archive" 


"delete tag logging archive 


objJHMIGO.DeleteTlgArchive strArchiveName 


Set objJHMIGO = Nothing 
End Sub 
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See also 
ListTlgTag Function (Page 2606) 
ListTlgArchive Function (Page 2604) 
GetTlgArchive Function (Page 2601) 
DeleteTlgTag Function (Page 2599) 
CreateTIgTag Function (Page 2592) 
CreateTlgArchive Function (Page 2589) 
CommitTlgTag Function (Page 2587) 
CommitTlgArchive Function (Page 2585) 
CloseTlgTag Function (Page 2583) 
CloseTlgArchive Function (Page 2581) 
VBA in Tag Logging (Page 2573) 


DeleteTlgTag Function 


Description 
Deletes the specified archive tag. 
syntax 
Expression. DeleteTlgTag (ArchiveName, TagName) 
Expression 
Necessary. An expression which returns a "HMIGO" type object. 
Parameters 
Parameter (Data Type) Description 
ArchiveName (String) Name of the archive containing the archive tag to 
be deleted 
TagName (string) Name of the archive tag to be deleted. 
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Example: 


Sub DeleteTlgTag () 

HMIGO 013 

procedure to delete a tag logging tag 
the archive need to be created befor 
the tag logging tag need to be created befor 
declarations 

Dim objJHMIGO As HMIGO 

Dim strArchiveName As String 

Dim strTlgTagName As String 

Set objHMIGO = New HMIGO 
strArchiveName = "NewArchive" 
strTlgTagName = "NewTag" 


' 
’ 
' 
' 


"current status is "EMPTY" 
MsgBox objHMIGO.ObjectStateTlgTag, vbOKOnly, "Status Tlg Tag" 
"delete tag logging tag 
objHMIGO.DeleteTlgTag strArchiveName, strTlgTagName 
Set objJHMIGO = Nothing 
End Sub 


See also 
ListTlgTag Function (Page 2606) 
ListTlgArchive Function (Page 2604) 
GetTlgArchive Function (Page 2601) 
DeleteTlgArchive Function (Page 2598) 
CreateTlgTag Function (Page 2592) 
CreateTlgArchive Function (Page 2589) 
CommitTlgTag Function (Page 2587) 
CommitTlgArchive Function (Page 2585) 
CloseTlgTag Function (Page 2583) 
CloseTlgArchive Function (Page 2581) 
VBA in Tag Logging (Page 2573) 


DeleteTigTrigger function 


Description 


Deletes the specified trigger. 
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Syntax 


Expression 


3.6 VBA Reference 


Expression.DeleteTlgTrigger (TriggerName) 


Required. An expression which returns a "HMIGO" type object. 


Parameter 


Parameter (Data Type) 
TriggerName (String) 


Description 
Name of the trigger that is deleted. 


GetTlgArchive Function 


Description 


Reads in the parameters of the specified archive. 


You can change or read the parameters by means of the object properties. You will find a list 
of the available object properties in this documentation under "VBA in TagLogging". 


syntax 


Expression 


Expression. GetTlgArchive (ArchiveName) 


Necessary. An expression which returns a "HMIGO" type object. 


Parameters 


Parameter (Data Type) 
ArchiveName (String) 


Description 


Name of the archive whose values are to be read 
in. 
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Example: 


Sub GetTlgArchive () 
HMIGO_014 


' procedure to open an archive 
" the archive need to be created befor 
' declarations 
Dim objJHMIGO As HMIGO 
Dim strArchiveName As String 
Set objJHMIGO = New HMIGO 
strArchiveName = "NewArchive" 
"current status is "EMPTY" 
MsgBox objHMIGO.ObjectStateTlgArchive, vbOKOnly, "Status Tlg Archive" 
‘open/ get tag logging archive 
objHMIGO.GetTlgArchive strArchiveName 
"current status is "OPENED" 
MsgBox objJHMIGO.ObjectStateTlgArchive, vbOKOnly, "Status Tlg Archive" 
Set objJHMIGO = Nothing 
End Sub 


See also 
CreateTlgTag Function (Page 2592) 
ListTlgTag Function (Page 2606) 
ListTlgArchive Function (Page 2604) 
GetTlgArchive Function (Page 2601) 
DeleteTIlgTag Function (Page 2599) 
DeleteTlgArchive Function (Page 2598) 
CreateTlgArchive Function (Page 2589) 
CommitTlgTag Function (Page 2587) 
CommitTlgArchive Function (Page 2585) 
CloseTlgTag Function (Page 2583) 
CloseTlgArchive Function (Page 2581) 
VBA in Tag Logging (Page 2573) 


GetTlgTag Function 


Description 
Reads in the parameters of the specified archive tag. 


You can change or read the parameters by means of the object properties. You will find a list 
of the available object properties in this documentation under "VBA in TagLogging". 
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syntax 
Expression. GetTlgTag (ArchiveName, TagName) 
Expression 
Necessary. An expression which returns a "HMIGO" type object. 
Parameters 
Parameter (Data Type) Description 
ArchiveName (String) Name of the archive containing the archive tag. 
TagName Name of the archive tag whose parameters are to 
be read in. 
Example: 


Sub GetTlgTag() 
' HMIGO_ 015 
procedure to close a tag logging tag 
" the archive need to be created befor 
'" the tag logging need to be created befor 
' declarations 
Dim objJHMIGO As HMIGO 
Dim strArchiveName As String 
Dim strTlgTagName As String 
Set objHMIGO = New HMIGO 
strArchiveName = "NewArchive" 
strTlgTagName = "NewTag" 


"current status is "EMPTY" 


MsgBox objHMIGO.ObjectStateTlgTag, vbOKOnly, "Status Tlg Tag" 


‘open/ get tag logging tag 
objHMIGO.GetTlgTag strArchiveName, strTlgTagName 
"current status is "OPENED" 


MsgBox objHMIGO.ObjectStateTlgTag, vbOKOnly, "Status Tlg Archive" 


Set objJHMIGO = Nothing 
End Sub 


See also 
CreateTIgTag Function (Page 2592) 
ListTlgTag Function (Page 2606) 
ListTlgArchive Function (Page 2604) 
GetTlgArchive Function (Page 2601) 
DeleteTIlgTag Function (Page 2599) 
DeleteTlgArchive Function (Page 2598) 
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CreateTIgArchive Function (Page 2589) 
CommitTlgTag Function (Page 2587) 
CommitTlgArchive Function (Page 2585) 
CloseTlgTag Function (Page 2583) 
CloseTlgArchive Function (Page 2581) 
VBA in Tag Logging (Page 2573) 


GetTlgTrigger function 


Description 


Syntax 


Parameter 


Reads in the parameters of the specified trigger. 


You can change or read the parameters by means of the object properties. You will find a list 
of the available object properties in this documentation under "VBA in TagLogging". 


Expression.GetTlgTrigger (TriggerName) 


Expression 
Required. An expression which returns a "HMIGO" type object. 


Parameter (Data Type) Description 


TriggerName (String) Name of the trigger whose values are read in. 


ListTlgArchive Function 


Description 


syntax 


2604 


Alternatively, the ListTlgArchive function returns the following Tag Logging values in a list: 
e All existing Tag Logging archives 


e All existing cycles / timers 


Expression.ListTlgArchive (ListType,pListArray, [Filter] ) 


Expression 
Necessary. An expression which returns a "HMIGO" type object. 
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Parameters 


Example: 


Parameter (Data Type) 
ListType (HMIGO_TLG_ARCHIVE_LIST_TYPE) 


3.6 VBA Reference 


Description 

Defines which content should be returned in a list. 

Possibilities are: 

e TLG_ARCHIVE_NAMES (1) All created Tag 
Logging archives 


@ TLG_ARCHIVE_TRIGGER_NAMES (2) All 
created cycles / timers 


pListArray (Variant) 


List with the requested content. 


Filter (String) 


Filters can be set optionally. A trigger name can 
be used as a filter. Wildcards "*" and "?" are also 
possible. 


In the following example, a check is made whether archives are configured: 


Sub ReadTlgArchives () 


'HMIGO_ 028 


‘read content in tag logging 


"no archives ar 


implemented 


Dim objJHMIGO As New HMIGO 
Dim varRange As Variant 
‘read all tlg archives 

objJHMIGO.ListTlgArchive TLG ARCHIVE NAMES, arrContent 


"check result 


MsgBox "no 
End If 
End Sub 


See also 


If (UBound(arrContent) - LBound(arrContent) + 1) <= 0 Then 


ntries because no tag logging archives are implemented" 


ListTlgTag Function (Page 2606) 
GetTlgArchive Function (Page 2601) 
DeleteTlgTag Function (Page 2599) 
DeleteTlgArchive Function (Page 2598) 
CreateTIgTag Function (Page 2592) 
CreateTIgArchive Function (Page 2589) 
CommitTlgTag Function (Page 2587) 
CommitTlgArchive Function (Page 2585) 
CloseTlgTag Function (Page 2583) 
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CloseTlgArchive Function (Page 2581) 
VBA in Tag Logging (Page 2573) 


ListTlgTag Function 


Description 
The ListTlgTag function returns all the tags created in a Tag Logging archive in a list. 
syntax 
Expression. ListTlgTag(ListType, ListArray, [ArchiveName], [Filter] ) 
Expression 
Necessary. An expression which returns a "HMIGO" type object. 
Parameters 


Parameter (Data Type) Description 


ListType (HMIGO_TLG_TAG_LIST_TYPE) Defines which content should be returned in a list. 
Possibilities are: 


TLG_TG_NAMES (1) All tags created in a Tag 
Logging archive 


ListArray (Variant) List with the requested content. 


ArchiveName (String) Name of the archive in Tag Logging (optional). If 
the name of the archive is not specified, all,archive 
tags are returned. 


Filter (String) Filters can be set optionally. Wildcards "*" and "2" 
are also possible. 
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Example: 


In the following example, a check is made whether the archive tags are configured in the 
"Process Archive": 


Sub ReadTlgTag() 
"HMIGO 029 
‘read content in tag logging 
"no tags within archives are implemented 
Dim objJHMIGO As New HMIGO 
Dim varRange As Variant 
Dim strArchive as String 
"set tlg archive name 
strArchive = "processarchive" 
‘read all tlg tags in specified archive 
objJHMIGO.ListTlgTag TLG TAG NAMES, arrContent, strArchive 
"check result 
If (UBound(arrContent) - LBound(arrContent) + 1) <= 0 Then 
MsgBox "no entries because no tag logging tags in specified archive are implemented" 
End If 
End Sub 


See also 
ListTlgArchive Function (Page 2604) 
GetTlgArchive Function (Page 2601) 
DeleteTIlgTag Function (Page 2599) 
DeleteTlgArchive Function (Page 2598) 
CreateTIgTag Function (Page 2592) 
CreateTIgArchive Function (Page 2589) 
CommitTlgTag Function (Page 2587) 
CommitTlgArchive Function (Page 2585) 
CloseTlgTag Function (Page 2583) 
CloseTlgArchive Function (Page 2581) 
VBA in Tag Logging (Page 2573) 


ListTlgTrigger function 


Description 


The function returns all created triggers in a list. 
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Syntax 


Parameter 


3.6.2.4 


Expression 


Expression.ListTlgTrigger (ListType, ListArray, [Filter] ) 


Required. An expression which returns a "HMIGO" type object. 


Parameter (Data Type) 


ListType (HMIGO_TLG_TRIGGER_LIST_TYPE) 


Description 


Defines the content that is to be returned in a list. 

Possibilities are: 

e TLG_TRIGGER_NAMES (1) all created 
triggers 


ListArray (Variant) 


List with the requested content. 


Filter (String) 


Filters can be set optionally. A trigger name can 
be used as a filter. Wildcards "*" and "?" are also 
possible. 


VBA in the Text Library 


VBA in the Text Library 


Introduction 


Principle 


2608 


VBA allows you to generate Text Library texts directly from the program code, modify and 


delete them, and display text IDs and texts. 


Note 


You should not have or should not open the "TextLibrary" editor when editing with VBA. 


When you have created the instance of the "HMIGO" class, the following functions are available 


to you to access the TextLibrary: 
e CreateTextLanguage 

e CreateText 

e DeleteText 

e DeleteTextLanguage 

e GetText 

e GetTextID 
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e ListText 

e ModifyText 

The following enumerations are available for the parameter supply of these functions: 
@ HMIGO_TEXT_CREATE_MODE 

@ HMIGO_TEXT_LIST_TYPE 


See also 
ModifyText Function (Page 2620) 
ListText Function (Page 2619) 
GetTextID Function (Page 2616) 
GetText Function (Page 2615) 
DeleteTextLanguage Function (Page 2614) 
DeleteText Function (Page 2612) 
CreateText Function (Page 2610) 
CreateTextLanguage Function (Page 2609) 
VBA in Other WinCC Editors (Page 2560) 


CreateTextLanguage Function 


Description 
Creates a language in the Text Library. 
syntax 
Expression.CreateTextLanguage (LanguageID) 
Expression 
Necessary. An expression which returns a "HMIGO" type object. 
Parameters 
Parameter (Data Type) Description 
LanguagelD (Long) ID for the language to be created (e.g. 1031 for 


German, 1033 for English, etc.) 


For a table of all language codes refer to the 
WinCC online help on "Language Identifiers". 
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Example: 


Sub CreateTextLanguage () 

' HMIGO 016 

" procedure to create a language in text library 
' language must not be created befor 
LanguageID german = 1031 
LanguageID english(US) = 1033 

' LanguageID spanish = 1034 
LanguageID french = 1040 
LanguageID farsi= 1065 

' declarations 

Dim objJHMIGO As HMIGO 

Dim IngLangugeNumber As Long 

Set objJHMIGO = New HMIGO 
IngLangugeNumber = 1065 "farsi 


"create new language 
objJHMIGO.CreateTextLanguage lIngLangugeNumber 
Set objJHMIGO = Nothing 

End Sub 


See also 
ModifyText Function (Page 2620) 
ListText Function (Page 2619) 
GetTextID Function (Page 2616) 
GetText Function (Page 2615) 
DeleteTextLanguage Function (Page 2614) 
DeleteText Function (Page 2612) 
CreateText Function (Page 2610) 
VBA in the Text Library (Page 2608) 


CreateText Function 


Description 


Creates a new text for the language specified. Text input for other languages can be added 
using ModifyText. 


syntax 


Expression.CreateText (LanguageID, Text, CreateMode, TextID) 


Expression 
Necessary. An expression which returns a "HMIGO" type object. 
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Parameters 


Parameter (Data Type) 
LanguagelD (Long) 


3.6 VBA Reference 


Description 


ID of the language for which the text will be created. 


Text (string) 


Text to be created. 


CreateMode (HMIGO_TEXT_CREATE_MODE) 


Mode of text creation: 


e TEXT_ADD_REFCOUNT (0) only increases 
the reference counter when an identical text 
already exists. 


e TEXT_CREATE_ALWAYS (1) always sets up 
a new text line and inserts the text in it. 


TextlD (long) 


Returns the TextID assigned to the new text or the 
TextID whose reference counter is increased. This 
ID is required for processing the text in other func- 
tions. 


Example: 


Sub CreateText () 

' HMIGO_017 

' procedure to creat 

declarations 

Dim objJHMIGO As HMIGO 

Dim lIngLanguageID As Long 

Dim lIngTextCreateMode As Long 

Dim IngTextID As Long 

Dim strText As String 

Set objHMIGO = New HMIGO 
strText = "new text" 

"LanguageID = english 

IngLanguageID = 1033 


a new text 
' 


"return value of ".CreateText" 


'"TEXT ADD REFCOUNT" check if text exists, if not create new text 


IngTextCreateMode = 0 


'"TEXT CREATE ALWAYS" create always a new text (for messages) 


'  IngTextCreateMode = 1 


"create new text 


objHMIGO.CreateText IngLanguageID, strText, IngTextCreateMode, lIngTextID 


"show TextID of created text 


MsgBox "TextID: " & IngTextID, vbOKOnly, 
Set objJHMIGO = Nothing 

End Sub 

See also 


ModifyText Function (Page 2620) 
ListText Function (Page 2619) 
GetTextID Function (Page 2616) 
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GetText Function (Page 2615) 
DeleteTextLanguage Function (Page 2614) 
DeleteText Function (Page 2612) 
CreateTextLanguage Function (Page 2609) 
VBA in the Text Library (Page 2608) 


DeleteText Function 


Description 
Deletes a line of text. All the languages for the corresponding line of text and the line of text 
itself are deleted. 
syntax 
Expression.DeleteText (TextID) 
Expression 
Necessary. An expression which returns a "HMIGO" type object. 
Parameters 
Parameter (Data Type) Description 
TextlD (long) ID of the line of text to be deleted 
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Example: 


Sub DeleteText () 
' HMIGO_018 
" procedure to delete a text 

text will be searched and deleted 

declarations 

Dim objJHMIGO As HMIGO 

Dim IngLanguageID As Long 

Dim IngTextID As Long "return value of GetTextID 
Dim strText As String 

On Error GoTo ErrorHandler 

Set objJHMIGO = New HMIGO 

strText = "new text" 

IngLanguageID = 1033 


"first: find text in text library and return TextID 
obj HMIGO.GetTextID 1033, strText, IngTextID 


‘if searched text exists: delete this text 


If Not lngTextID = -1 Then 
objJHMIGO.DeleteText IngTextID 
MsgBox "Text : """ & strText & """ found in TextID: " & IngTextID & vbNewLine & _ 
"TextID is deleted!", vbOKOnly, "Result DeleteText" 
Else 
MsgBox "Text : """ & strText & """ not found." & vbNewLine & _ 
"No Text deleted!", vbOKOnly, "Result DeleteText" 
End If 
Set objJHMIGO = Nothing 
Exit Sub 
ErrorHandler: 
‘if IngText = (-1),searched text does not exit 
If lngTextID = -1 Then 


"reset errorhandler 
Err.Clear 
Resume Next 
End If 
sgBox "ErrNr. : " & Err.Number & vbNewLine & _ 
'ErrDes.: " & Err.Description, vbOKOnly, "Error ocurred" 
"reset errorhandler 
Err.Clear 
End Sub 


See also 
VBA in the Text Library (Page 2608) 
ModifyText Function (Page 2620) 
ListText Function (Page 2619) 
GetTextID Function (Page 2616) 
GetText Function (Page 2615) 
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DeleteTextLanguage Function (Page 2614) 
CreateText Function (Page 2610) 


CreateTextLanguage Function (Page 2609) 


DeleteTextLanguage Function 


Description 

Enables a language to be deleted from the TextLibrary. In this case, all the texts in this 

language are also deleted. 
syntax 

Expression. DeleteTextLanguage (LanguageID) 

Expression 

Necessary. An expression which returns a "HMIGO" type object. 
Parameters 

Parameter (Data Type) Description 

LanguagelD (Long) ID of the language to be deleted 
Example: 


In the following example, a check is made whether the language '1036' exists. If it does, it will 


be deleted. 


Sub DeleteLanguage () 
"HMIGO_030 


Dim objJHMIGO As New HMIGO 
Dim varRange As Variant 
Dim intLanguage As Long 
Dim lngPointer As Long 
get all existing languages 


delete an existing languages in TextLibrary 
language '1036'/spanish has to exist 


objJHMIGO.ListText TEXT LANGUAGE IDS, arrContent 


check requested list for language 


'1036'/ spanish and delete 


For IngPointer = LBound(arrContent) To UBound(arrContent) 
intLanguage = arrContent(lngPointer) + Val("&H400") 


If intLanguage = 1036 Then 
"delete language 


obj HMIGO.DeleteTextLanguage intLanguage 


End If 
Next lngPointer 
End Sub 
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See also 
GetText Function (Page 2615) 
ModifyText Function (Page 2620) 
ListText Function (Page 2619) 
GetTextID Function (Page 2616) 
DeleteText Function (Page 2612) 
CreateText Function (Page 2610) 
CreateTextLanguage Function (Page 2609) 
VBA in the Text Library (Page 2608) 
GetText Function 
Description 
Returns the text for the selected text ID in the selected language. 
syntax 
Expression.GetText (LanguageID, TextID, Text) 
Expression 
Necessary. An expression that returns an object of the type "HMIGeneralObjects". 
Parameters 
Parameter (Data Type) Description 
LanguagelD (Long) ID of the language of the text to be read 
TextlD (long) ID of the line of text from which text is to be read 
Text (string) Returns the text of the selected line of text and 
language. 
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Example: 


Sub GetText () 


' HMIGO 019 

" procedure to get a text 

" text with TextID = '69' need to be created 
' declarations 


Dim objJHMIGO As HMIGO 

Dim IlngLanguageID As Long 

Dim lngTextID As Long 

Dim strText As String "return value of GetText 
Set objHMIGO = New HMIGO 

IngTextID = 69 

IngLanguageID = 1033 


"find text text library 
obj HMIGO.GetText IngLanguageID, IngTextID, strText 


"show found text 
MsgBox "Read Text in TextID : " & lngTextID & "is """ & strText & """ I", 
vbOKOnly, "Result GetText" 
Set objJHMIGO = Nothing 
End Sub 


See also 
ModifyText Function (Page 2620) 
ListText Function (Page 2619) 
GetTextID Function (Page 2616) 
DeleteTextLanguage Function (Page 2614) 
DeleteText Function (Page 2612) 
CreateText Function (Page 2610) 
CreateTextLanguage Function (Page 2609) 
VBA in the Text Library (Page 2608) 


GetTextID Function 


Description 
Returns the ID of the text searched for in the selected language. 


If there are several texts with the same contents, only the line of text with the lowest ID is 
returned. Whether there are several lines of text with the same contents depends on the 
CreateMode of the CreateText function. 
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syntax 
Expression. GetTextID(LanguageID, Text, TextID) 
Expression 
Necessary. An expression which returns a "HMIGO" type object. 
Parameters 
Parameter (Data Type) Description 
LanguagelD (Long) ID of the language of the text searched for 
Text (string) The text searched for 
TextID (long) ID of the line of text in which the text searched for 
was found 
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Example: 


Sub GetTextID() 

" HMIGO 020 

" procedure to search a TextID 

text will be searched and a TextID will be returned 
declarations 

Dim objJHMIGO As HMIGO 

Dim IngLanguageID As Long 

Dim IngTextID As Long "return value of GetTextID 
Dim strText As String 

On Error GoTo ErrorHandler 

Set objJHMIGO = New HMIGO 

strText = "old text" 

ingLanguageID = 1033 


"first: find text in text library and return TextID 
obj HMIGO.GetTextID 1033, strText, IngTextID 


‘if searched text exists: delete this text 


If Not IlngTextID = -1 Then 
MsgBox "Text : """ & strText & """ found in TextID: " & IngTextID, 
vbOKOnly, "Result GetTextID" 
Else 
MsgBox "Text : """ & strText & """ not found!", vbOKOnly, "Result GetTextID" 
End If 
Set objJHMIGO = Nothing 
Exit Sub 
ErrorHandler: 
"if IngText = (-1),searched text does not exit 
If lngTextID = -1 Then 


"reset errorhandler 
Err.Clear 
Resume Next 
End If 
MsgBox "ErrNr. : " & Err.Number & vbNewLine & 
'ErrDes.: " & Err.Description, vbOKOnly, "Error ocurred" 
"reset errorhandler 
Err.Clear 
End Sub 


See also 
ModifyText Function (Page 2620) 
ListText Function (Page 2619) 
GetText Function (Page 2615) 
DeleteTextLanguage Function (Page 2614) 
DeleteText Function (Page 2612) 
CreateText Function (Page 2610) 
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CreateTextLanguage Function (Page 2609) 
VBA in the Text Library (Page 2608) 


ListText Function 


Description 
Alternatively, the ListText function returns the following contents of the TextLibrary as a list: 
e All languages created 
e All text IDs 


e All texts in a specific language 


syntax 
Exoression.ListText (ListType, pListArray, [LanguageID], [Filter] ) 
Expression 
Necessary. An expression which returns a "HMIGO" type object. 
Parameters 
Parameter (Data Type) Description 
ListType (HMIGO_TEXT_LIST_TYPE) Defines which content should be returned as a list. 


Possibilities are: 


@ TEXT_LANGUAGE_IDS (1) All the created 
languages. The result still has to be converted 
by adding 400hex. 


e TEXT_IDS (2) All text IDs. 
@ TEXT_TEXTS (3) All texts in a language. 


pListArray (Variant) List with the requested content. 
LanguagelD (Long) The language ID whose text is to be returned. 
Filter (String) Filters can be set optionally. Wildcards "*" and "?" 


are also possible. 
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Example: 


In the following example, a check is made whether the list with the text of a language is empty 
because the language does not exist: 


Sub ReadTextsByLanguage () 
"HMIGO 031 
"read content in textLibrary by language 
Dim objJHMIGO As New HMIGO 
Dim varRange As Variant 
Dim intLanguage As Integer 
"set invalid language ID 
intLanguage = 1051 ‘language does not exist 
"read all texts 
objJHMIGO.ListText TEXT TEXTS, arrContent, intLanguage 
"check result 


If (UBound(arrContent) - LBound(arrContent) + 1) <= 0 Then 
MsgBox "no entries because wrong language selection" 
End If 
End Sub 
See also 


ModifyText Function (Page 2620) 
GetTextID Function (Page 2616) 

GetText Function (Page 2615) 
DeleteTextLanguage Function (Page 2614) 
DeleteText Function (Page 2612) 
CreateTextLanguage Function (Page 2609) 
VBA in the Text Library (Page 2608) 


ModifyText Function 


Description 


Modifies the text for the selected language with the ID specified. 


syntax 


Expression.ModifyText (LanguageID, TextID, Text) 


Expression 
Necessary. An expression which returns a "HMIGO" type object. 
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Parameters 
Parameter (Data Type) Description 
LanguagelD (Long) ID of the language of the text to be changed. 
TextID (long) ID of the language of the text to be changed. 
Text (string) New text to be inserted. 

Example: 


Sub ModifyText () 
' HMIGO_021 
" procedure to modify a text 
" text will be searched and replaced 
' declarations 
Dim objJHMIGO As HMIGO 
Dim IngLanguageID As Long 
Dim lngTextID As Long "return value of GetTextID 
Dim strOldText As String 
Dim strNewText As String 
On Error GoTo ErrorHandler 
Set objJHMIGO = New HMIGO 
strOldText = "old text" 
strNewText = "new text" 
IngLanguageID = 1033 


"first: find text in text library and return TextID 
obj HMIGO.GetTextID 1033, strOldText, IngTextID 


‘if searched text exists: replace this text 


If Not IlngTextID = -1 Then 
objJHMIGO.ModifyText lIngLanguageID, lngTextID, strNewText 
MsgBox "Text : """ & strOldText & """ found in TextID: " & IngTextID & vbNewLine & _ 
"Text replaced with : """ & strNewText & """ !", vbOKOnly, "Result DeleteText" 
Else 
MsgBox "Text : """ & strOldText & """ not found." & vbNewLine & _ 
"No Replacements done!", vbOKOnly, "Result DeleteText" 
End If 
Set objJHMIGO = Nothing 
Exit Sub 
ErrorHandler: 
‘if IngText = (-1),searched text does not exit 
If lngTextID = -1 Then 


"reset errorhandler 
Err.Clear 
Resume Next 
End If 
MsgBox "ErrNr. : " & Err.Number & vbNewLine & 
'ErrDes.: " & Err.Description, vbOKOnly, "Error ocurred" 
"reset errorhandler 
Err.Clear 


End Sub 
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See also 


3.6.2.5 


ListText Function (Page 2619) 

GetTextID Function (Page 2616) 

GetText Function (Page 2615) 
DeleteTextLanguage Function (Page 2614) 
DeleteText Function (Page 2612) 
CreateText Function (Page 2610) 
CreateTextLanguage Function (Page 2609) 
VBA in the Text Library (Page 2608) 


VBA in Alarm Logging 


VBA in Alarm Logging 


Introduction 


Principle 
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VBA allows you to create messages directly from the program code, modify them, and delete 
them. 


Note 


You should not have or should not open the "Alarm Logging" editor when editing with VBA. 


When you have created the instance of the "HMIGO" class, the following functions are available 
to you to access Alarm Logging: 


e CloseSingleAlarm 

e CommitSingleAlarm 

e CreateSingleAlarm 

e DeleteSingleAlarm 

e GetSingleAlarm 

e ListSingleAlarm 

The following enumerations are available for the parameter supply of these functions: 
e HMIGO_SINGLE_ALARM_CLASS_IDS 

@ HMIGO_SINGLE_ALARM_LIST_TYPE 
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Access to the Object Properties 


You can also access the parameters of the above-mentioned functions directly in VBA by 
means of the following object properties: 


Object property Description Read/Write 


ObjectStateSingleAlarm Returns the object state via the enumeration HMIGO_OB- Yes/no 
JECT_STATE. Further information on this enumeration can be found 
in this documentation under "VBA in other WinCC Editors". 


SingleAlarmMessageNumber Number of the message Yes/no 

SingleAlarmAGNumber AS Number Yes/yes 
SingleAlarmCPUNumber CPU number of the AGs. Yes/yes 
SingleAlarmClassID Message class of the message. Possible values of the Enum SIN- Yes/yes 


GLE_ALARM_CLASS_IDS: 

e SINGLE_ALARM_ERROR (1) 

e =SINGLE_ALARM_CLASS_2 (2) 

e SINGLE_ALARM_CLASS_3 (3) 

e SINGLE_ALARM_CLASS_4 (4) 

e SINGLE_ALARM_CLASS_5 (5) 
) 
) 
) 


e SINGLE_ALARM_CLASS_6 (6 
e SINGLE_ALARM_CLASS_7 (7 
e SINGLE_ALARM_CLASS_8 (8 
e SINGLE_ALARM_CLASS_9 (9) 
e SINGLE_ALARM_CLASS_10 (10 
e =SINGLE_ALARM_CLASS_11 (11 
e SINGLE_ALARM_CLASS_12 (12 
e =SINGLE_ALARM_CLASS_13 (13 
e SINGLE_ALARM_CLASS_14 (14 
e =SINGLE_ALARM_CLASS_15 (15 
e SINGLE_ALARM_CLASS_16 (16) 


e SINGLE_ALARM_CLASS_SYSTEM_REQUIRE_ACKNOWLEDG 
EMENT (17) 

¢ SINGLE_ALARM_CLASS_SYSTEM_WITHOUT_ACKNOWLEDG 
EMENT (18) 


SingleAlarmMessageTypelD Type ID of the message. The permissible values depend on the mes- | Yes/yes 
sage class: 


e Class 1: Values from 1 to 16 
e Class 2: Values from 17 to 32 
Class 3: Values from 33 to 48 


e Class 18: 273 and 274 


SingleAlarmTextXxID The properties SingleAlarmText1ID to SingleAlarmText10ID exist for | Yes/yes 
XX = 1...10 the user texts 1 to 10. 
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Object property Description Read/Write 
SingleAlarmTagNameProcessVa- | For the process values there are the properties SingleAlarmTagName- | Yes/yes 
lueXxX ProcessValue1 through 10 
XX = 1...10 If you want to delete a configured process value, you must describe 

this parameter with a tag of the type "Long", which has the value "0".”) 
SingleAlarmTagName Tag name for event Yes/yes 
SingleAlarmMessageBit Bits for bit reporting procedure Yes/yes 
SingleAlarmQuitTag Tag name for acknowledgment status Yes/yes 
SingleAlarmQuitBits Bit for bit reporting procedure Yes/yes 
SingleAlarmStateTag Tag for status query Yes/yes 
SingleAlarmStateBits Bit for status tag Yes/yes 
SingleAlarmNormDLL Name of the conversion DLL Yes/yes 
SingleAlarmQuitSingle Acknowledgment of the messages, TRUE or FALSE possible Yes/yes 
SingleAlarmHornActivate Activation of the horn, TRUE or FALSE possible Yes/yes 
SingleAlarmArchiving Archiving of the message, TRUE or FALSE possible Yes/yes 
SingleAlarmProtocol Logging of the message, TRUE or FALSE possible Yes/yes 
SingleAlarmFlanklInvert Triggering of message at falling edge, TRUE or FALSE possible Yes/yes 
SingleAlarmLockedOnStart Message is disabled at system startup, TRUE or FALSE possible Yes/yes 
SingleAlarmGlobalAPFunction Forward message to global AP function, TRUE or FALSE possible Yes/yes 
SingleAlarmActionName Name of the action Yes/yes 
SingleAlarmActionParams Parameters of the action Yes/yes 
SingleAlarmInfoText Information text for message Yes/yes 
SingleAlarmGroup Name of the user-defined group message assigned to a message. Yes/yes 


Sub DeleteSingleAlarmTagNameProcessValuel () 


"HMIGO_ 033 

Dim objJGO as HMIGO 
Dim var as Long 
var = 0 


Set objGO = new HMIGO 


‘message 1 will be modified 
objGO.GetSingleAlarm 1 
objGO.SingleAlarmTagNameProcessValuel = var 
objGO.CommitSingleAlarm 


Set objGO = nothing 
End Sub 


See also 


ListSingleAlarm Function (Page 2633) 
GetSingleAlarm Function (Page 2632) 
DeleteSingleAlarm Function (Page 2631) 


CreateSingleAlarm Function (Page 2628) 
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CommitSingleAlarm Function (Page 2626) 
CloseSingleAlarm Function (Page 2625) 
VBA in Other WinCC Editors (Page 2560) 


CloseSingleAlarm Function 


Description 


Closes the message which is open. 


Note 


Modified parameters are not saved. If the current value should be saved, execute the 
CommitSingleAlarm() function again. 


syntax 


Expression.CloseSingleAlarm() 


Expression 


Necessary. An expression which returns a "HMIGO" type object. 


Parameters 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, A5E37536061-AA 2625 


VBA for Automated Configuration 


3.6 VBA Reference 


Example: 


Sub CloseSingleAlarm () 
' HMIGO_ 22 
' procedure to open a singlealarm 
" message #100 need to be created befor 
' declarations 

Dim objJHMIGO As HMIGO 

Dim lngMsgNumber As Long 

Set objHMIGO = New HMIGO 

IngMsgNumber = 100 
"current status is "EMPTY" 

MsgBox objHMIGO.ObjectStateSingleAlarm, vbOKOnly, 
‘open a singlealarm 

objJHMIGO.GetSingleAlarm lngMsgNumber 

"current status is "OPENED" 

MsgBox objHMIGO.ObjectStateSingleAlarm, vbOKOnly, 
"close a singlealarm 

objJHMIGO.CloseSingleAlarm 

‘current status is "EMPTY" 

MsgBox objHMIGO.ObjectStateSingleAlarm, vbOKOnly, 


Set objJHMIGO = Nothing 
End Sub 


See also 
ListSingleAlarm Function (Page 2633) 
GetSingleAlarm Function (Page 2632) 
DeleteSingleAlarm Function (Page 2631) 
CreateSingleAlarm Function (Page 2628) 
CommitSingleAlarm Function (Page 2626) 
VBA in Alarm Logging (Page 2622) 


CommitSingleAlarm Function 


"Status SingleAlarm" 


"Status SingleAlarm" 


"Status SingleAlarm" 


Description 
Writes the changed parameters of the open message to WinCC. 
Note 
To change further parameters after a CommitSingleAlarm call, write these changes to WinCC 
by calling the function again. 
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syntax 

Expression.CommitSingleAlarm() 

Expression 

Necessary. An expression which returns a "HMIGO" type object. 
Parameters 
Example: 


Sub CommitSingleAlarm() 
" HMIGO 023 
' procedure to change a property of a singlealarm 
" message #100 need to be created befor 
' declarations 
Dim objJHMIGO As HMIGO 
Dim lngMsgNumber As Long 
Dim lngMsgBitNumber As Long 
Set objJHMIGO = New HMIGO 
IngMsgNumber = 100 
IngMsgBitNumber = 10 
"current status is "EMPTY" 
MsgBox objHMIGO.ObjectStateSingleAlarm, vbOKOnly, 
‘open a singlealarm 
objJHMIGO.GetSingleAlarm lngMsgNumber 
"current status is "OPENED" for changes 
MsgBox objHMIGO.ObjectStateSingleAlarm, vbOKOnly, 
"change a property 
objJHMIGO.SingleAlarmMessageBit = lngMsgBitNumber 
"current status is "MODIFIED" for changes 
MsgBox objHMIGO.ObjectStateSingleAlarm, vbOKOnly, 
‘commit a single alarm 
objJHMIGO.CommitSingleAlarm 
"current status is "OPENED" 
MsgBox objHMIGO.ObjectStateSingleAlarm, vbOKOnly, 


Set objJHMIGO = Nothing 
End Sub 


See also 
ListSingleAlarm Function (Page 2633) 
GetSingleAlarm Function (Page 2632) 
DeleteSingleAlarm Function (Page 2631) 
CreateSingleAlarm Function (Page 2628) 
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CloseSingleAlarm Function (Page 2625) 
VBA in Alarm Logging (Page 2622) 


CreateSingleAlarm Function 


Description 


syntax 


Parameters 
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Creates a new message. 


tlID,MessageTagName, MessageBit) 


Expression 


Expression.CreateSingleAlarm(MessageNumber, ClassID,MessageTypelID, Tex 


Necessary. An expression which returns a "HMIGO" type object. 


Parameter (Data Type) 


MessageNumber (long) 


Description 
Number of the message. 


e lf an unused message number is specified 
here, it is accepted. 

e Ifthe value "0" is entered, the message number 
is freely assigned by the system. In this case, 
the message number is given back here. 


ClassID (HMIGO_SINGLE_ALARM_CLASS_IDS) 


Message class. The possible values are in the ta- 
ble Enum HMIGO_SIN- 
GLE_ALARM_CLASS_IDS. 


MessageTypelD (Integer) 


The permissible values depend on the message 
class: 


e Class 1: Values from 1 to 16 
e Class 2: Values from 17 to 32 
e Class 3: Values from 33 to 48 


e Class 18: Values from 263 to 288 


Text1ID (Long) 


ID for the first user text. The ModifySingleAlarm 
function can be used to define nine further user 
texts (1-10). 


MessageTagName (String) 


Tag name for the event. 


MessageBit (integer) 


Bit in bit reporting process (0...31) 


WinCC: Scripting (VBS, ANSI-C, VBA) 
System Manual, 02/2016, ASE37536061-AA 


VBA for Automated Configuration 


Default Values When a New Message Is Created 


3.6 VBA Reference 


The following table indicates the default values that are entered when a new message is 
created. These properties can be modified. The modifications are saved using the 


ModifySingleAlarm function. 

Parameters Default Value (Enum | Comment 
Name => Value) 

SingleAlarmAGNumber 0 -- 
SingleAlarmCPUNumber 0 -- 
SingleAlarmTextXXID No text entered -- 
SingleAlarmTagNameProcessVa- No tag entered -- 
luexx 
SingleAlarmQuitTag No tag entered -- 
SingleAlarmQuitBits 0 No bits set. 


SingleAlarmStateTag 


SingleAlarmStateBits 


No tag entered 


0 


Corresponds to exactly one day. Only 
relevant in the case of compressed 
tags. 


No bits set. 


SingleAlarmNormDLL 


No name entered 


SingleAlarmQuitSi 


ngle 


FALSE 


Single acknowledgment, no group ac- 
knowledgment 


SingleAlarmHornActivate FALSE Horn Not active. 
SingleAlarmArchiving TRUE Message will be archived. 
SingleAlarmProtocol TRUE Message is logged. 
SingleAlarmFlanklInvert FALSE Not activated. 
SingleAlarmLockedOnStart FALSE Message is not disabled. 
SingleAlarmGlobalAP|Function FALSE Message is not forwarded. 


SingleAlarmAction 


Name 


No name entered 


SingleAlarmAction 


Params 


No parameters en- 
tered for the action 


SingleAlarminfoText 


No text entered 


SingleAlarmGroup 


No text entered 


Enum HMIGO_SINGLE_ALARM_CLASS_IDS 


The following message classes are available for selection: 


Values 
SINGLE_ALARM_ 


ERROR (1) 


Description 


SINGLE_ALARM 


CLASS_2 (2 


SINGLE_ALARM 


CLASS_3 (3 


SINGLE_ALARM 


CLASS_4 (4 


SINGLE_ALARM 


SINGLE_ALARM 


CLASS_6 (6 


SINGLE_ALARM 


CLASS_7 (7 


SINGLE_ALARM 


) 
) 
) 
CLASS_5 (5) 
) 
) 
) 


CLASS_8 (8 
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Values 


SINGLE_ALARM_CLASS 


Description 


SINGLE_ALARM_CLASS 


SINGLE_ALARM_CLASS 


SINGLE 
SINGLE 


ALARM 
ALARM 


CLASS 
CLASS 


SINGLE_ALARM_CLASS 


SINGLE_ALARM_CLASS 


SINGLE_ALARM_CLASS_16 (16) 


SINGLE_ALARM_CLASS 


SYSTEM_REQUIRE_ACKNOWLEDGEMENT (17) 


SINGLE_ALARM_CLASS 


SYSTEM_WITHOUT_ACKNOWLEDGEMENT (18) 


Example: 


Sub CreateSingleAlarm() 


text library 


thin the message variable 


ERROR 


ID from textlibrary 


' HMIGO_ 024 

" procedure to create a SingleAlarm 

" message must not be created befor 

" message Text ID need to be created before in 

' declarations 
Dim objJHMIGO As HMIGO 
Dim strMsgText As String "message text 
Dim strMsgTagName As String "message variable 
Dim lngMsgNumber As Long "message number 
Dim IngMsgBitNumber As Long "bit number wi 
Dim lngMsgTypeID As Long "message type 
Dim lngMsgClassID "SINGLE ALARM 1 
Dim lngMsgTextID As Long "message text 
Set objHMIGO = New HMIGO 
strMsgText = "NewText" 

"current status is "EMPTY" 


MsgBox objHMIGO.ObjectStateSingleAlarm, 
"preset regqiured parameter 


IngMsgNumber = 50 

ingMsgClassID = 1 

IngMsgTypeID = 2 

IngMsgTextID = 69 

strMsgText = "new text message" 

strMsgTagName = "NewVariable" 

IngMsgBitNumber = 5 

"create a tag 

objJHMIGO.CreateSingleAlarm lngMsgNumber, SINGLE ALARM | 
strMsgTagName, lngMsgBitNumber 

"current status is "OPENED" 


MsgBox objHMIGO.ObjectStateSingleAlarm, 
Set objJHMIGO Nothing 
End Sub 
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vbOKOnly, 


"Status SingleAlarm" 


ERROR, IngMsgTypeID, lngMsgTextID, 


vbOKOnly, 


"Status SingleAlarm" 
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See also 
ListSingleAlarm Function (Page 2633) 
GetSingleAlarm Function (Page 2632) 
DeleteSingleAlarm Function (Page 2631) 
CommitSingleAlarm Function (Page 2626) 
CloseSingleAlarm Function (Page 2625) 
VBA in Alarm Logging (Page 2622) 


DeleteSingleAlarm Function 


Description 
Deletes the specified message. 
syntax 
Expression.DeleteSingleAlarm (MessageNumber) 
Expression 
Necessary. An expression which returns a "HMIGO" type object. 
Parameters 
Parameter (Data Type) Description 
MessageNumber (long) Number of the message to be deleted. 
Example: 


Sub DeleteSingleAlarm() 
' HMIGO_025 
' procedure to delete a singlealarm 
" message #100 need to be created befor 
' declarations 
Dim objJHMIGO As HMIGO 
Dim lngMsgNumber As Long 


Set objHMIGO = New HMIGO 
IngMsgNumber = 100 
‘current status is "EMPTY" 

MsgBox objHMIGO.ObjectStateSingleAlarm, vbOKOnly, "Status SingleAlarm" 


"delete a singlealarm 
objJHMIGO.DeleteSingleAlarm lngMsgNumber 
Set objJHMIGO = Nothing 

End Sub 
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See also 
VBA in Alarm Logging (Page 2622) 
ListSingleAlarm Function (Page 2633) 
GetSingleAlarm Function (Page 2632) 
CreateSingleAlarm Function (Page 2628) 
CommitSingleAlarm Function (Page 2626) 
CloseSingleAlarm Function (Page 2625) 


GetSingleAlarm Function 


Description 
Reads in the parameters of the message entered. 
You can change or read the parameters by means of the object properties. You will find a list 
of the available object properties in this documentation under "VBA in Alarm Logging". 
syntax 
Expression.GetSingleAlarm(MessageNumber) 
Expression 
Necessary. An expression which returns a "HMIGO" type object. 
Parameters 


Parameter (Data Type) Description 


MessageNumber (long) The message number of the message to be read 
in. 
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Example: 


Sub GetSingleAlarm() 
" HMIGO 026 
' procedure to open a singlealarm 
' message #100 need to be created befor 
' declarations 
Dim objJHMIGO As HMIGO 
Dim lngMsgNumber As Long 
Set objHMIGO = New HMIGO 
IngMsgNumber = 100 
"current status is "EMPTY" 
MsgBox objHMIGO.ObjectStateSingleAlarm, vbOKOnly, "Status SingleAlarm" 
‘open/ get a tag 
objJHMIGO.GetSingleAlarm lngMsgNumber 
"current status is "OPENED" 
MsgBox objHMIGO.ObjectStateSingleAlarm, vbOKOnly, "Status SingleAlarm" 
Set objJHMIGO = Nothing 
End Sub 


See also 
ListSingleAlarm Function (Page 2633) 
DeleteSingleAlarm Function (Page 2631) 
CreateSingleAlarm Function (Page 2628) 
CommitSingleAlarm Function (Page 2626) 
CloseSingleAlarm Function (Page 2625) 
VBA in Alarm Logging (Page 2622) 


ListSingleAlarm Function 


Description 
The ListSingleAlarm function returns the content of Alarm Logging in a list: 
e All actions created which are linked to messages 
e All message class IDs created 
e Allinfo texts created 
e All message numbers created 
e All message type IDs created 
e All message classes created 


e All group messages created 
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syntax 
Expression. ListSingleAlarm(ListType,pListArray, [Filter] ) 
Expression 
Necessary. An expression which returns a "HMIGO" type object. 
Parameters 
Parameter (Data Type) Description 
ListType (HMIGO_SIN- Defines which content should be returned in a list. Pos- 
GLE_ALARM_LIST_TYPE) sibilities are: 

@ SINGLE_ALARM_ACTION_NAMES (1) All actions 
created for Loop In Alarm when the parameter is set 
in the configuration as a string 

e SINGLE_ALARM_CLASS_IDS (2) All message class 
IDs created 

@ SINGLE_ALARM_INFO_TEXTS (3) All info texts 
created 

@ SINGLE_ALARM_MESSAGE_NUMBERS (4) All 
message numbers created 

@ SINGLE_ALARM_MESSAGE_TYPE_IDS (5) All 
message type IDs created 

@ SINGLE_ALARM_GROUP_MESSAGE_CLASSES 
(6) All message classes created 

@ SINGLE_ALARM_GROUP_MESSAGE_USER_DEF 
INED (7) All group messages created 

pListArray (Variant) List with the requested content. 
Filter (String) Filters can be set optionally. Wildcards "*" and "?" are 
also possible. 
Example: 


In the following example, a check is made whether info texts have been configured: 


Sub ReadSingleAlarm() 
"HMIGO_ 032 
"read content in alarm logging 
"‘no info texts are implemented 
Dim objJHMIGO As New HMIGO 
Dim varRange As Variant 
"read all info texts 
objJHMIGO.ListSingleAlarm SINGLE ALARM INFO TEXTS, arrContent 
"check result 


If (UBound(arrContent) - LBound(arrContent) + 1) <= 0 Then 
MsgBox "no entries because no info texts are implemented" 
End If 
End Sub 
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